Skip to content

HTTP status codes

200 OK

The request has been accepted and processed. The response contains a JSON object.

400 Bad Request

The server cannot process the request due to something that is perceived to be a client error, for example malformed request syntax.

It can happen when the JSON object posted with the request is invalid.

For example, the following is not a valid JSON object because both the external curly braces and the quotation marks around the properties names are missing.

document: {
    text: "Michael Jordan was one of the best basketball players of all time. Scoring was Jordan's stand-out skill, but he still holds a defensive NBA record, with eight steals in a half."
}

401 Unauthorized

The reasons for this state can be:

403 Forbidden

This code is returned when requesting resources that are outside the scope of the plan that the user subscribed or when one or more of the plan limits—for example the characters per month limit—have been reached.

404 Not Found

The server can not find the requested resource, the URL is wrong.

413 Request Entity Too Large

The request is larger than the limit defined by the plan the user subscribed.

500 Internal Server Error

The server has encountered a situation it doesn't know how to handle.