Skip to main content

Responses and status codes

Responses and status codes

The Loaded API uses JSON as the response format for all requests. Information about the success or failure of the processing of the request is returned to the client through the HTTP response status code. Refer to the API Reference to know what specific status codes can be returned from individual request endpoints.

Status codes

CodeDescription
200 OKThe request was successfully processed.
201 CreatedThe request has been fulfilled and a new resource has been created.
400 Bad RequestThe request wasn't in a format that was acceptable, generally due to invalid or missing parameters or because the Content-Type was not set to application/json.
401 UnauthorizedThe required Authorization header was either missing or incorrect. Check the token isn't expired.
403 ForbiddenThe server is refusing to respond to the request. Check that the access token being used has the appropriate scopes for the request being made.
404 Not FoundThe requested resource was not found.
409 ConflictThere is a conflict with an existing resource. Check that any unique keys don't already exist.
429 Too Many RequestsThe client has sent too many requests within the last minute and is being rate limited.
500 Internal Server ErrorAn internal error occured in the Loaded platform. Please let use know, including details of the ErrorId if available, so we can investigate.
503 Service UnavailableThe server is currently unavailable. Check the Loaded status page for reported service outages.