Skip to content

Error handling

SmartMaps APIs use standard HTTP status codes. A 2xx status indicates success, 4xx a problem with the request, and 5xx a server-side problem.

Common status codes

Code Meaning
400 Bad Request The request was malformed — e.g. invalid JSON or a parameter out of its allowed range.
401 Unauthorized Authentication failed — missing or invalid API key, token or credentials.
412 Precondition Failed A required precondition was not met — e.g. the API key was not provided.
500 Internal Server Error An unexpected server-side error. Retry later; if it persists, contact support.

Each service lists the codes specific to its endpoints in its own API Reference.

Rate limiting

Usage is governed by your transaction quota rather than per-second rate limits.