The Docsumo API uses HTTP Status codes to reflect successful and error requests. 2XX status codes represent a successful request, 4XX/5XX status codes represent an error took place. If you receive an error HTTP status code, check the body for an error code and message.
Valid Server Response
{
"data": []
"status": "success",
"status_code": 200
}
Error response
{
"status_code": 400,
"message": "Validation Failed.",
"error_code": "UNAUTHORIZED"
}
Status Code | Description | Most Likely Cause |
---|---|---|
2XX | Successful Request | |
400 | Bad Request | Invalid/missing data |
401 | Unauthorized | Invalid/missing credentials |
404 | Not Found | The resource does not exist, ex. invalid/non-existent user id |
409 | Conflict | Trying to overwrite a resource, ex. when creating a user with an email that already exists |
429 | Too Many Requests | Hit an API rate limit |
50X | server error | We made some mistake. Contact us |