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 CodeDescriptionMost Likely Cause
2XXSuccessful Request
400Bad RequestInvalid/missing data
401UnauthorizedInvalid/missing credentials
404Not FoundThe resource does not exist, ex. invalid/non-existent user id
409ConflictTrying to overwrite a resource, ex. when creating a user with an email that already exists
429Too Many RequestsHit an API rate limit
50Xserver errorWe made some mistake. Contact us