Errors
The Searoutesnav API uses conventional HTTP response codes to indicate success or failure of an API request. Below is a list of the most common status codes you may encounter.
| Status Code | Meaning |
|---|---|
| 200 | OK – The request was successful. |
| 400 | Bad Request – Invalid parameters or malformed request. |
| 401 | Unauthorized – Missing or invalid API key. |
| 403 | Forbidden – Your account does not have access to this resource. |
| 404 | Not Found – The requested resource could not be found. |
| 422 | Unprocessable Entity – The request body failed validation (e.g. an invalid emissions payload). |
| 429 | Too Many Requests – Daily query limit exceeded. |
| 500 | Internal Server Error – Something went wrong on our side. |
| 503 | Service Unavailable – A subsystem (e.g. the emissions service) is temporarily unavailable. |
Error Response Example
{
"status": 401,
"error": "Unauthorized",
"message": "Missing or invalid API key."
}