A guide to Sendchamp API Error Codes

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.

CodeNameDescription
200OKEverything worked as expected.
400Bad RequestYour request could not be processed. Often due to missing a required parameter.
400JSON Parse ErrorWe encountered an unspecified JSON parsing error. This error means that your JSON was formatted incorrectly or was considered invalid or incomplete.
401API Key MissingYour 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.
401API Key InvalidYour API key may be invalid. Check that your API key was input correctly.
403ForbiddenYou are not permitted to access this resource.
403ForbiddenYou do not have enough money in your wallet.
404Not FoundThe 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.
405Method Not AllowedThe 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.
429Too Many RequestsYou have maxed your number of API calls for the provided time window.
500,
502,
503,
504
Server errorsAn 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.