Errors

Error Codes

The Codat API uses the following error codes:

Error Code

Meaning

400

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

401

Unauthorized – Your Codat API key is wrong.

402

Payment required – You have reached a limit set by your plan.

403

Forbidden – either:

  1. The requested endpoint is hidden for administrators only, or
  2. A downstream endpoint cannot be accessed

404

Not Found – The resource could not be found.

405

Method Not Allowed – You tried to access a method with an invalid method.

500

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

503

Service Unavailable – We're temporarily offline for maintenance. 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"
}