API Reference

Errors

Glossary of common errors returned by the Capmo API.

Bad Request

A 400 Bad Request status code indicates that the server cannot process the request due to a client error (e.g., malformed request syntax, size too large, invalid request message framing, or deceptive request routing). Check the request payload and parameters to ensure they adhere to the API documentation. Review the error message for specific information about what part of your request is incorrect.

Invalid Input

A special case of Bad Request, this error code indicates validation errors in the input data. It usually implies that the data sent by the client fails to pass validation checks, such as format errors, missing fields, or data range issues. Review the API documentation for the correct input formats and required fields, and ensure that all inputs meet the specified criteria before resending the request.

Unauthorized

If you receive a 401 Unauthorized status code, it means that the request has not been applied because it lacks valid authentication credentials for the target resource. Ensure you are sending the correct authentication tokens or API keys in your request headers, see Authentication for details. If you continue to encounter this error, verify that your tokens are valid and have not expired.

Forbidden

Receiving a 403 Forbidden status code means that the server understood your request but refuses to authorize it. This usually occurs when the user does not have the necessary permissions for a resource or if specific conditions apply. Verify your account permissions and ensure that your API key has access to the requested resources.

Not Found

The 404 Not Found status code means that the server cannot find the requested resource. This can occur for various reasons, such as the resource has been removed or the URL is incorrect. Double-check the URL and the resource identifier. If the issue persists, ensure that the resource exists and is correctly spelled.

Conflict

Receiving 409 Conflict status code should be understood as a conflict with the current state of a resource, such as when trying to create or update a resource that already exists or has conflicting information. This status code indicates that the request cannot be completed due to a conflict with the current state of the resource.

Internal Server Error

A 500 Internal Server Error status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request. This is a generic error message when the server encounters a problem but cannot specify the issue. If this error persists, contact the API support team for assistance.