Errors

Shipbubble APIs uses conventional HTTP response codes to indicate the success or failure of an API request.

In general: Code “200” indicates success. Codes in the 4xx range indicate an error that failed given the information provided (e.g. a required parameter was omitted, invalid request body, etc.). Codes in the 5xx range indicate an error with Shipbubbles' servers (these are rare).

Below is a description of our error codes:

Response code
Description

400

Invalid request, account error (eg no kyc, insufficient wallet balance etc), description is usually included in message property

401

No valid API key provided

403

API key does not have permission to perform request

404

Requested resource is not found

422

Invalid data values sumbitted in the request body

429

Too many requests, rate limit reached

500

Our servers cannot process request at the moment (These are rare)

503

Third-party service unavailable (please contact us as soon as you see this error)

Last updated