HTTP Responses

Each API call returns an HTTP status code that reflects the nature of the response. We have done our best to follow the HTTP status code conventions.

Any request that did not succeed will return a 4xx or 5xx error. The 4xx range means there was a problem with the request, like a missing parameter. The 5xx range means that something went wrong on our end.

Salesmachine API returns the following codes:

Code

Meaning

200

OK – Request succeeded

201

Created – A resource was created

400

Bad Request – Incorrect or missing API key

401

Unauthorized – Your API key is wrong

404

Not Found – The specified url could not be found

405

Method Not Allowed – You tried to access our api with an invalid method

406

Not Acceptable – You requested a format that isn’t json

429

Too Many Requests – You’re sending too many requests! Slow down, or if you have a high traffic webapp, contact us :-)

500

Internal Server Error – We had a problem with our server. Try again later.

503

Service Unavailable – We’re temporarily offline for maintenance. Please try again later.