FleetWorkAPI Docs

Status Codes

HTTP status codes returned by the Fleetwork API.

Success Codes

CodeMeaningDescription
200OKRequest succeeded
201CreatedResource was created
204No ContentRequest succeeded, no body returned

Client Error Codes

CodeMeaningDescription
400Bad RequestInvalid parameters or malformed JSON
401UnauthorizedMissing/invalid API key or no module access
403ForbiddenInsufficient permissions
404Not FoundResource does not exist
409ConflictResource state conflict (e.g., duplicate entry)
422UnprocessableValidation failed
429Too Many RequestsRate limit or quota exceeded

Server Error Codes

CodeMeaningDescription
500Internal ErrorSomething went wrong on our side
502Bad GatewayUpstream service error
503Service UnavailableTemporary outage

Error Response Format

All errors return a consistent JSON structure:

{
  "code": "BAD_REQUEST",
  "message": "The field 'name' is required.",
  "data": null
}

401 Unauthorized Example

{
  "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": []
}

429 Rate Limit Exceeded

{
  "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"
}

429 Quota Exceeded

{
  "error": "quota_exceeded",
  "message": "Monthly quota exceeded",
  "limit": 100000,
  "used": 100001
}

On this page