Skip to main content
The UseDropTrail API uses conventional HTTP response codes to indicate the success or failure of API requests.

​
Response Codes

  • 200 - OK: Request succeeded
  • 201 - Created: Resource was successfully created
  • 400 - Bad Request: Invalid request parameters or validation failed
  • 401 - Unauthorized: Missing or invalid authentication
  • 403 - Forbidden: Authenticated but insufficient permissions
  • 404 - Not Found: Requested resource doesn’t exist
  • 429 - Too Many Requests: Rate limit exceeded
  • 500 - Internal Server Error: Something went wrong on our end

​
Error Response Format

When an error occurs, the API returns a JSON response with error details:
​
error
string
Error message
​
message
string
Detailed error description
​
status
number
HTTP status code
​
code
string
Error code
​
details
object
Additional error details

​
Example Error Response

{
  "error": "Invalid request",
  "message": "The request is invalid",
  "status": 400,
  "code": "INVALID_REQUEST"
}
This response indicates that the request was invalid due to missing or incorrect parameters. The error field provides a concise message, while the message field offers a more detailed explanation. The status code is 400, and the code is INVALID_REQUEST. For more detailed information, you can refer to the details object, which includes the name of the field that caused the error. This format helps you quickly identify and resolve issues in your API requests.