# Danh sách Job

> Lấy danh sách job có phân trang cho tài khoản Fleetwork của bạn.

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

**GET** `https://live.fleetwork.vn/api/v1/workspace/jobs`

## Tham số query

| Tham số         | Kiểu    | Bắt buộc | Mô tả                                                             |
| --------------- | ------- | -------- | ----------------------------------------------------------------- |
| `page`          | integer | Tuỳ chọn | Số trang (mặc định: `1`)                                          |
| `size`          | integer | Tuỳ chọn | Số mục mỗi trang (mặc định: `10`)                                 |
| `jobStatus`     | integer | Tuỳ chọn | `0`=New, `1`=Scheduled, `2`=InProgress, `3`=Completed, `4`=Failed |
| `jobType`       | integer | Tuỳ chọn | `0`=Unknown, `1`=Shipment, `2`=Service                            |
| `userId`        | UUID    | Tuỳ chọn | Lọc theo ID tài xế được gán                                       |
| `vehicleId`     | UUID    | Tuỳ chọn | Lọc theo ID xe được gán                                           |
| `keyword`       | string  | Tuỳ chọn | Tìm kiếm theo tên job                                             |
| `fromDate`      | long    | Tuỳ chọn | Lọc ngày bắt đầu dạng Unix timestamp (ms)                         |
| `toDate`        | long    | Tuỳ chọn | Lọc ngày kết thúc dạng Unix timestamp (ms)                        |
| `startDate`     | long    | Tuỳ chọn | Lọc theo ngày bắt đầu của job (Unix ms)                           |
| `endDate`       | long    | Tuỳ chọn | Lọc theo ngày kết thúc của job (Unix ms)                          |
| `descStartDt`   | boolean | Tuỳ chọn | Sắp xếp giảm dần theo ngày bắt đầu                                |
| `descCreatedDt` | boolean | Tuỳ chọn | Sắp xếp giảm dần theo ngày tạo                                    |

## Ví dụ

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