Error Handling

Response codes and troubleshooting

The API uses standard HTTP status codes and returns JSON error responses.

HTTP Status Codes

Code	Description
`200`	Success
`201`	Created
`400`	Bad Request - Invalid parameters
`401`	Unauthorized - Invalid or missing authentication
`403`	Forbidden - Insufficient scope or permissions
`404`	Not Found - Resource doesn't exist
`429`	Too Many Requests - Rate limit exceeded
`500`	Server Error - Something went wrong on our end

{
    "error": "invalid_request",
    "error_description": "The 'id' parameter is required."
}

`invalid_request`	Missing or invalid parameter
`invalid_client`	Invalid client credentials
`invalid_grant`	Invalid or expired authorization code/token
`unauthorized_client`	Client not authorized for this grant type
`unsupported_grant_type`	Grant type not supported
`invalid_scope`	Invalid or unsupported scope
`access_denied`	User denied the authorization request