Errors

HTTP Response Codes

Warrant APIs can return any of the following HTTP response codes indicating errors:

HTTP Response Code	Meaning
400 Bad Request	Your request is invalid. You may be missing a required parameter or may have passed an invalid value for a parameter.
401 Unauthorized	Your request is missing a valid API or session token.
403 Forbidden	The caller (identified by API or session token) does not have access to this particular endpoint or resource.
404 Not Found	The specified resource could not be found.
405 Method Not Allowed	You attempted to use a method not supported or allowed by the API.
429 Too Many Requests	You performed too many requests in a given period of time and triggered the rate limiter. Please see the Rate Limits section for more details.
500 Internal Server Error	The server had a problem while serving your request. The request can be safely retried.
503 Service Unavailable	The server is unavailable to process your request. If this error persists, it likely indicates a broader outage. Please see the status page for up-to-date details.
504 Gateway Timeout	The server timed out while processing your request. These errors are uncommon and likely transient. They can be safely retried.

Error Details

Warrant APIs can also include more detailed, Warrant-specific error codes and messages useful for debugging and error-handling. These errors are returned as JSON in responses as follows:

{
    "code": "invalid_parameters",
    "message": "Invalid typeId. Must only contain alphanumeric characters."
}