APIAPI ReferenceJob Management

List Jobs

Retrieve a paginated list of jobs for your Fleetwork account.

GETlive.fleetwork.vn/api/v1/workspace/jobs

Query Parameters

pageintegerOptional
Page number (default: 1)
sizeintegerOptional
Items per page (default: 10)
jobStatusintegerOptional
0=New, 1=Scheduled, 2=InProgress, 3=Completed, 4=Failed
jobTypeintegerOptional
0=Unknown, 1=Shipment, 2=Service
userIdUUIDOptional
Filter by assigned driver ID
vehicleIdUUIDOptional
Filter by assigned vehicle ID
keywordstringOptional
Search by job name
fromDatelongOptional
Start date filter as Unix timestamp (ms)
toDatelongOptional
End date filter as Unix timestamp (ms)
startDatelongOptional
Filter by job start date (Unix ms)
endDatelongOptional
Filter by job end date (Unix ms)
descStartDtbooleanOptional
Sort descending by start date
descCreatedDtbooleanOptional
Sort descending by created date

Example

Request

Shell

curl -X GET \
  "https://live.fleetwork.vn/api/v1/workspace/jobs?page=1&size=10&jobStatus=2&jobType=1&fromDate=1713139200000&toDate=1713225600000" \
  -H "API-KEY: <your-key>"

Response

JSON

{
  "code": "OK",
  "message": null,
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "accountId": "a1b2c3d4-0000-0000-0000-000000000000",
      "jobName": "Delivery Batch #42",
      "jobDescription": "Morning delivery run",
      "refNo": "JB-2026-0042",
      "status": 2,
      "jobType": 1,
      "createdDt": 1713139200000,
      "modifiedDt": 1713225600000,
      "tasks": []
    }
  ],
  "total": 85,
  "page": 1,
  "pageSize": 10
}