Issues

Issues capture operational problems reported against orders, drivers, vehicles, or other resources. Use issues to track incidents, exceptions, and resolution status during fulfillment.

The Issue object

An issue records a driver- or vehicle-reported operational problem. It includes report text, priority, category, type, status, location, assignee, reporter, and resolution timestamps.

Attributes

idstringoptional

Public issue identifier.

assigneeobjectoptional

User assigned to the issue, when loaded.

reporterobjectoptional

User who reported the issue, when loaded.

vehicleobjectoptional

Vehicle associated with the issue, when loaded.

driverobjectoptional

Driver associated with the issue, when loaded.

issue_idstringoptional

Human-friendly issue identifier.

titlestringoptional

Issue title.

reportstringoptional

Issue report text.

prioritystringoptional

Issue priority.

metaobjectoptional

Additional issue metadata.

typestringoptional

Issue type.

categorystringoptional

Issue category.

tagsarray of stringsoptional

Tags associated with the issue.

statusstringoptional

Issue status.

locationobjectoptional

Location where the issue was reported.

resolved_attimestampoptional

Timestamp when the issue was resolved.

updated_attimestampoptional

Timestamp when the issue was last updated.

created_attimestampoptional

Timestamp when the issue was created.

The Issue object

{
  "id": "issue_8Qw2YxM3Nf",
  "driver_name": "Alex Driver",
  "vehicle_name": "ABC123",
  "issue_id": "ISS-1001",
  "title": null,
  "report": "Flat tire near the pickup location.",
  "priority": "high",
  "meta": {},
  "type": "vehicle",
  "category": "maintenance",
  "tags": [],
  "status": "open",
  "location": {
    "latitude": 1.3521,
    "longitude": 103.8198
  },
  "resolved_at": null,
  "updated_at": "2026-05-07T08:30:00.000000Z",
  "created_at": "2026-05-07T08:30:00.000000Z"
}

POST/v1/issues

Create an Issue

Body parameters

driverstringrequired

Driver ID reporting the issue.

locationobjectrequired

Location where the issue was reported.

reportstringrequired

Issue report text submitted by the caller.

categorystringoptional

Category used to classify the issue.

typestringoptional

Issue type.

prioritystringoptional

Priority level for the issue.

POST/v1/issues

curl -X POST https://api.fleetbase.io/v1/issues \
  -H "Authorization: Bearer flb_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "driver": "{{driver_id}}",
  "location": {
    "latitude": 1.3521,
    "longitude": 103.8198
  },
  "report": "Vehicle tire pressure warning",
  "category": "vehicle",
  "type": "maintenance",
  "priority": "medium",
  "status": "open"
}'

GET/v1/issues

Query Issues

Query parameters

limitintegeroptional

Maximum number of issues to return.

offsetintegeroptional

Number of issues to skip before returning results.

sortstringoptional

Sort expression for the issue query.

driverstringoptional

Filters issues by driver ID.

vehiclestringoptional

Filters issues by vehicle ID.

statusstringoptional

Filters issues by status.

GET/v1/issues

curl https://api.fleetbase.io/v1/issues?limit=25&offset=0&sort=created_at \
  -H "Authorization: Bearer flb_live_…"

GET/v1/issues/:id

Retrieve an Issue

GET/v1/issues/:id

curl https://api.fleetbase.io/v1/issues/:id \
  -H "Authorization: Bearer flb_live_…"

PUT/v1/issues/:id

Update an Issue

Body parameters

reportstringrequired

Issue report text submitted by the caller.

categorystringoptional

Category used to classify the issue.

typestringoptional

Issue type.

prioritystringoptional

Priority level for the issue.

PUT/v1/issues/:id

curl -X PUT https://api.fleetbase.io/v1/issues/:id \
  -H "Authorization: Bearer flb_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "report": "Updated issue report",
  "category": "vehicle",
  "type": "maintenance",
  "priority": "high",
  "status": "resolved"
}'

DELETE/v1/issues/:id

Delete an Issue

DELETE/v1/issues/:id

curl -X DELETE https://api.fleetbase.io/v1/issues/:id \
  -H "Authorization: Bearer flb_live_…"