Job Management
List Jobs
Retrieve a paginated list of jobs for your Fleetwork account.
GET/api/v1/workspace/jobs
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
page | integer | Optional | Page number (default: 1) |
size | integer | Optional | Items per page (default: 10) |
jobStatus | integer | Optional | 0=New, 1=Scheduled, 2=InProgress, 3=Completed, 4=Failed |
jobType | integer | Optional | 0=Unknown, 1=Shipment, 2=Service |
userId | UUID | Optional | Filter by assigned driver ID |
vehicleId | UUID | Optional | Filter by assigned vehicle ID |
keyword | string | Optional | Search by job name |
fromDate | long | Optional | Start date filter as Unix timestamp (ms) |
toDate | long | Optional | End date filter as Unix timestamp (ms) |
startDate | long | Optional | Filter by job start date (Unix ms) |
endDate | long | Optional | Filter by job end date (Unix ms) |
descStartDt | boolean | Optional | Sort descending by start date |
descCreatedDt | boolean | Optional | Sort descending by created date |
Example
Request
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
{
"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
}