Skip to main content

Errors

HTTP Response Codes

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

HTTP Response CodeMeaning
400 Bad RequestYour request is invalid. You may be missing a required parameter or may have passed an invalid value for a parameter.
401 UnauthorizedYour request is missing a valid API or session token.
403 ForbiddenThe caller (identified by API or session token) does not have access to this particular endpoint or resource.
404 Not FoundThe specified resource could not be found.
405 Method Not AllowedYou attempted to use a method not supported or allowed by the API.
429 Too Many RequestsYou 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 ErrorThe server had a problem while serving your request. The request can be safely retried.
503 Service UnavailableThe 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 TimeoutThe 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."
}