Error Handling
HTTP status codes and their meanings in the Open VTS API.
The API uses conventional HTTP status codes to indicate the outcome of a request. Codes in the 2xx range indicate success, 4xx indicate a client error, and 5xx indicate a server error.
Status Codes
200
Success
Request completed successfully.
201
Created
A new resource was created.
400
Bad Request
Validation errors or invalid input.
401
Unauthorized
Missing or expired JWT token.
403
Forbidden
Insufficient role permissions for the endpoint.
404
Not Found
The requested resource does not exist.
409
Conflict
Duplicate resource (e.g. duplicate IMEI).
429
Too Many Requests
Rate limit exceeded — back off and retry.
500
Internal Server Error
Unexpected server failure.