Skip to content

Errors

v2 returns every error in one format, with a stable code you can handle in code and a readable message:

{
  "errors": [
    { "code": "resource_not_found", "message": "The requested resource does not exist." }
  ]
}

Use the HTTP status first, then the code. The most common ones:

HTTP statusCodeWhen you see it
400parameter_not_foundA required field is missing or blank
400parameter_invalidA value is not valid, for example an unknown provider_id when fetching slots
400out_of_rangeA range or count is outside what is allowed, for example a slots range over 7 days
401missing_authorization, token_expiredNo bearer token was sent, or it has expired
403action_forbiddenThe action isn't allowed for this account
404resource_not_foundThe id does not exist, for example when deleting an unknown service
409resource_conflictThe request conflicts with the current state, for example a duplicate category title
413payload_too_largeA value is larger than allowed
429You are sending requests too quickly. Slow down and retry.
500server_errorSomething went wrong on our side

The full list of error codes is in the Getting Started section at the top of this page.