Status Codes

The Senmo API uses conventional HTTP response codes to indicate the outcome of an API request. Response codes can be grouped into the following categories:

  • 2xx: The request was successful.

  • 4xx: An error occurred due to the information provided, e.g., missing or incorrect parameters.

  • 5xx: Those errors are returned if there was an error in Senmo servers.

Senmo API error responses all follow a standard format. They include the HTTP response code, the reason for the error, and a unique ID for use with Senmo customer support.

Error response parameters

2xx Success

Status CodeDescription

200

The request succeeded.

201

The request succeeded and the request was created.

4xx Client Errors

Status CodeDescription

401 Unauthorized

The API key was invalid.

403 Forbidden

The account does not have access to the requested resource, or the request is blocked for security reasons.

404 Not Found

The resource that was requested could not be found.

5xx Server Errors

Status CodeDescription

500 Internal Server Error

Error Our server encountered an error while processing your request. We will be notified and work on a fix immediately.

502 Bad Gateway

Our server encountered an error while processing your request. We will be notified and work on a fix immediately.

503 Service Unavailable

Our server encountered an error while processing your request. We will be notified and work on a fix immediately.

504 Gateway Timeout

Our server encountered an error while processing your request. We will be notified and work on a fix immediately.

Last updated