​

Errors and Status Codes

• Codes in the 2xx range indicate success.
• Codes in the 4xx range indicate an error that failed given the information provided (e.g. missing required field or authentication failure).
• Codes in the 5xx range indicate an error with Pingr AI servers.

​

Error Response Structure

{
  "error": {
    "code": "resource_not_found",
    "message": "Voice agent with ID ag_98f1bc could not be found.",
    "type": "invalid_request_error",
    "param": "agent_id",
    "doc_url": "https://pingr.ai/docs/api-reference/errors#resource_not_found"
  }
}

​

Error Object Attributes

• code: A machine-readable string indicating the exact error category.
• message: A human-readable description explaining why the error occurred and how to fix it.
• type: Broad error classification (e.g. invalid_request_error, authentication_error, rate_limit_error, api_error).
• param: The specific request parameter that triggered the error (if applicable).
• doc_url: Direct hyperlink to resolution documentation.

​

HTTP Status Codes

​

Error Code Reference