API Responses

XCover uses conventional HTTP response codes to indicate the success or failure of API requests. Error codes ranging from 200 to 299 indicate successful operations. Error codes ranging from 400 to 499 represent various error codes. Errors that can be resolved programmatically will result in an error code that briefly explains the error type and the reason for failure. 5xx codes indicate an unexpected error within the XCover application. In the unlikely event of a 5xx error, our engineering team will automatically receive a notification and will fix the issue as fast as possible.

Status

Description

200 - OK

Everything worked as expected

201 - Created

The request has been fulfilled and has resulted in one or more new resources being created

400 - Bad Request

The request was not accepted, often due to the wrong format of the request

401 - Unauthorized

No valid API key was provided

404 - Not Found

The requested resource doesn't exist

409 - Conflict

The request conflicts with another request, perhaps due to the usage of the same idempotency key

422 - Unprocessable Entity

Validation failed or logical error

429 - Too Many Requests

Too many requests hit the API too quickly. We recommend an exponential back-off of your requests.

500, 502, 503, 504 - Server Errors

Something went wrong on XCover side

Last updated