# List Jobs

> Retrieve a paginated list of jobs for your Fleetwork account.

Source: https://docs.fleetwork.vn/en/jobs/jobs-list

**GET** `https://live.fleetwork.vn/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

```bash
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
}
```