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)