Status Codes HTTP status codes returned by the Fleetwork API.
Code Meaning Description 200OK Request succeeded 201Created Resource was created 204No Content Request succeeded, no body returned
Code Meaning Description 400Bad Request Invalid parameters or malformed JSON 401Unauthorized Missing/invalid API key or no module access 403Forbidden Insufficient permissions 404Not Found Resource does not exist 409Conflict Resource state conflict (e.g., duplicate entry) 422Unprocessable Validation failed 429Too Many Requests Rate limit or quota exceeded
Code Meaning Description 500Internal Error Something went wrong on our side 502Bad Gateway Upstream service error 503Service Unavailable Temporary outage
All errors return a consistent JSON structure:
{
"code" : "BAD_REQUEST" ,
"message" : "The field 'name' is required." ,
"data" : null
}
{
"error" : "unauthorized" ,
"message" : "No access to module: Driving Alert" ,
"status" : "Invalid - No Active Modules" ,
"errors" : [ "API key does not have access to module: Driving Alert" ],
"warnings" : []
}
{
"error" : "rate_limit_exceeded" ,
"message" : "Rate limit exceeded: 10 requests per second" ,
"limit" : 10 ,
"reset_at" : "2026-04-15T09:31:00Z" ,
"retry_after" : "2026-04-15T09:31:00Z"
}
{
"error" : "quota_exceeded" ,
"message" : "Monthly quota exceeded" ,
"limit" : 100000 ,
"used" : 100001
}