Response Status Codes

Learn more about Mintlify

Enter your email to receive updates about new features and product releases.

Success codes

On a successful request, the response status will be one of the following:

Code	Name	When returned
`200`	OK	Successful GET, PATCH, or DELETE request.
`201`	Created	Successful POST that creates a new resource. The response body contains the newly created entity in JSON format.
`204`	No Content	Successful request with no response body (e.g., DELETE).

Example of a successful request

GET /api/users/1 HTTP/1.1

HTTP/1.1 200 OK
Request URL: http://localhost.com/api/users/1
Request Method: GET
Status Code: 200 OK
Remote Address: 127.0.0.1:80

When an error occurs, the response status code indicates the type of error:

Code	Name	Description
`400`	Bad Request	The request is malformed, such as misformatted JSON in the request body.
`401`	Unauthorized	No or invalid authentication details are provided.
`403`	Forbidden	Authentication succeeded but the authenticated user does not have access to the resource.
`404`	Not Found	A non-existent resource was requested.
`500`	Internal Server Error	The server encountered an unexpected condition that prevented it from fulfilling the request.

Example of an error response

GET /api/users/999 HTTP/1.1

HTTP/1.1 404 Not Found
Request URL: http://localhost.com/api/users/999
Request Method: GET
Status Code: 404 Not Found
Remote Address: 127.0.0.1:80

See Error Messages for details on the error response body format.

⌘I