Sendchamp uses conventional HTTP response codes to indicate success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that resulted from the provided information (e.g. a required parameter was missing, user is not unauthorized, etc.), and codes in the 5xx range indicate an error from the server.

Code

Name

Description

200

OK

Everything worked as expected.

400

Bad Request

Your request could not be processed. Often due to missing a required parameter.

400

JSON Parse Error

We encountered an unspecified JSON parsing error. This error means that your JSON was formatted incorrectly or was considered invalid or incomplete.

401

API Key Missing

Your request did not include an API key. This error suggests that your API key was missing from your request, or that something was formatted or named improperly in your header.

401

API Key Invalid

Your API key may be invalid. Check that your API key was input correctly.

403

Forbidden

You are not permitted to access this resource.

403

Forbidden

You do not have enough money in your wallet.

404

Not Found

The requested resource could not be found. This error tells you a specific resource doesn't exist. It's possible that the resource has been moved or deleted, or that there's a typo in your request.

405

Method Not Allowed

The requested method and resource are not compatible. See the Allow header for this resource's available methods. This error means that the requested resource does not support the HTTP method you used.

429

Too Many Requests

You have maxed your number of API calls for the provided time window.

500,
502,
503,
504

Server errors

An unexpected internal error has occurred at our end. Please contact Support for more information. This error lets you know our servers have experienced a problem. Although this is rare, please contact [email protected] to let us know that you've encountered this error.