Reference

Error Handling

All errors are returned as JSON with a consistent shape. Use the code field for programmatic handling.

HTTP status codes

CodeMeaning
200Success
400Bad Request — missing or invalid parameters
401Unauthorized — missing or invalid API key
403Forbidden — your key lacks the required scope
404Not Found — the resource does not exist
429Rate Limited — slow down and retry
500Server Error — something went wrong on our end

Error shape

{
  "error": "Contact not found",
  "code": "NOT_FOUND",
  "statusCode": 404
}