Skip to main content
The API acts on behalf of the user who owns the ID token. What it returns depends on that user.

Accounting firm isolation

Every call is limited to the user’s accounting firm. A customer that belongs to another firm is reported as not found (customerNotFound), exactly like a customer that does not exist. Creating a customer whose enterprise number another firm already registered returns 403 belongsToAnotherTenant. See also: Errors

Confidential customers

Customers flagged as confidential are only visible to users with the Administrator access level. For other users, they are left out of lists, and so are their mandates and files. Requesting such a customer directly returns 403 accessDenied.

Customer restrictions per user

The accounting firm can restrict a user to one or more of its customers. It sets this up itself, in MyCodaclean, when it creates or edits the user. The API then only returns those customers, with their mandates and files. Reading or changing another customer returns 403 accessDenied. This is typically how an end customer, rather than the accountant, uses your software: the accounting firm gives them an account restricted to their own company.

Download tracking

When you acknowledge a CODA or CODB file download, the acknowledgement is recorded for your API key and the user. Another user of the same software still sees the file as new. See also: Download CODA files