Response codes

Following are the HTTP response codes our API may return.

CodeStatusDescription
200OKIt worked!
201CreatedThe resource was created successfully. The body should contain a "links" map with a "self" field that contains the new URL to access the created resource. Alternatively, the URL will be in the "Location" header
202AcceptedWhen using test_auth=true, this response code indicates that the auth_token is valid.
204No ContentThe request succeeded and the response does not contain any content.
400Bad RequestThe request was invalid. You may be missing a required argument or provided bad data. An error message will be returned explaining what happened.
401UnauthorizedThe authentication you provided is invalid.
403ForbiddenYou don't have permission to complete the operation or access the resource.
404Not FoundYou requested an invalid method.
405Method Not AllowedThe method specified in the Request-Line is not allowed for the resource identified by the Request-URI. (used POST instead of PUT)
429Too Many RequestsYou have exceeded the rate limit.
500Internal Server ErrorSomething is wrong on our end. We'll investigate what happened. Feel free to contact us.
503Service UnavailableThe method you requested is currently unavailable (due to maintenance or high load).

Rate this page: