Status codes

Status codes

The status codes used in Codat are listed in the table below.

Status code





Accepted (pending)


Bad Request -- The server cannot or will not process the request due to an apparent client-side error.


Unauthorized -- Your Codat API key is incorrect.


Account limits have been reached. Either:

  • You have exceeded the company limit.

  • You have requested a sync schedule that is not allowed for your account type.

  • Your account has expired.

If you have exceeded the company limit, we suggest that you delete any companies you no longer need and retry the request.

If your account has expired, please contact our solutions team.


Forbidden -- either:

  • The requested endpoint is for administrators only, or

  • A downstream endpoint cannot be accessed.


Not Found -- either:

  • The resource could not be found, or

  • Data type is not support by the platform.
    In such case, the error message would be: Datatype 'yyy' not supported by platform(s) 'zzz'.


Method Not Allowed -- You are using an unauthorized method.


Conflict -- The resource is not ready.

If syncing a data set, this could mean that either:

  • The data set has not been requested.

  • The syncing of data set has not been completed.


Too Many Requests -- You have made too many requests in a given amount of time. Please retry later.


Internal Server Error -- We had a problem with our server. Please try again later.


Service Unavailable -- We're temporarially offline for maintanance. Please try again later.

Error Responses

The content of an error response should include a more detailed error message and a correlationId which can be used to identify a particular response to Codat support. If you are contacting Codat support regarding an error, please include the correlationId in text format.

  "statusCode": 404,
  "service": "QuickbooksOnline",
  "error": "InvoicePdfNotFoundException: Invoice not found for company 360cb9b3-d9cf-4f66-b8db-8a3523fe3dc5 and invoice ID 12345",
  "correlationId": "131f0225-5467-421a-b179-4531d6b4a942"

Status codes in asynchronous push responses

Status codes for push operations created in Codat API may be different from the status codes returned in the responses from the service providers. When a push operation is created in Codat API, some service providers may use a 202 Accepted code (to imply that the request has been accepted for processing, but the processing has not completed). However, push API may return a 200 Success code for the push operation successfully created in Codat API.

Did this page help you?