​
API Responses

Unless specified otherwise, the API returns JSON payloads both on success and errors. A successful response looks like: 
{
  "result": {
    ... actual payload goes here...
  }
}
An error payload is structured like: 
{
  "error": {
    "type": "not_found",
    "message": "Recording was not found"
  }
}
Some kind of errors may carry additional information. For instance validation_error may define the location of the element failing the check in path attribute. 

{
  "error": {
    "type": "validation_error",
    "message": "Value is not a valid integer",
    "path": "limit"
  }
}

​
Dates

Request dates can be sent in ISO format variants: 
2025-02-25T13:00:44.602Z
2025-02-25T13:00:44Z
2025-02-25T13:00Z
2025-02-25T13:00
2025-02-25
Response dates are in ISO format, UTC. 
"createdAt": "2025-02-25T13:00:44.602Z"

​
API Error Codes

Claap API uses the following error codes:
CodeDescription
200OK, everything worked as expected
400There was something wrong with your request. Check the response body for a detailed error message
401Unauthorized, API key was not supplied or is not valid
404Not found, requested resource cannot be retrieved
429Too many requests. Check the response headers for information about the state of rate limiting
500Internal error. Contact us if the error persists.