# List jobs

> Source: https://pixelsystems.com/docs/api/list-jobs


List an application's jobs, one page at a time. Each entry carries the jobId, status, metadata, and timestamps; fetch the full result from /v1/jobs/{jobId}.

`GET /v1/jobs`

## Request

```http
GET /v1/jobs
Authorization: Bearer {api_key}
```

## Query parameters

| Parameter | Type | Description | Required |
| --- | --- | --- | --- |
| applicationId | `string (uuid)` | The application whose jobs to list. Must be the application the API key belongs to; any other value returns `unauthorized`. | Yes |
| page | `integer` | Page to return, counted from 1. | No |
| pageSize | `integer` | Number of jobs per page. Values above 100 are clamped to 100, not rejected. | No |

## Example request

```bash
curl -X GET "https://api.pixelsystems.com/v1/jobs?applicationId=660e8400-e29b-41d4-a716-446655440001&page=1&pageSize=20" \
  -H "Authorization: Bearer {api_key}" \
  -H "Content-Type: application/json"
```

## Response (200)

Paginated list of jobs

| Field | Type | Description |
| --- | --- | --- |
| jobs | [`array<JobSummary>`](https://pixelsystems.com/docs/api/resources#jobsummary) | Jobs for the application, newest first. Each entry is a compact summary; `GET /v1/jobs/{jobId}` returns the full result. |
| pagination | [`PaginationMeta`](https://pixelsystems.com/docs/api/resources#paginationmeta) | Page-based pagination metadata for list responses. |

## Example response

```json
{
  "jobs": [
    {
      "jobId": "550e8400-e29b-41d4-a716-446655440001",
      "status": "processing",
      "createdAt": "2026-06-01T12:04:00Z"
    },
    {
      "jobId": "550e8400-e29b-41d4-a716-446655440000",
      "status": "completed",
      "metadata": { "customer_case_id": "case-123" },
      "createdAt": "2026-06-01T12:00:00Z",
      "completedAt": "2026-06-01T12:00:14Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "total": 2,
    "totalPages": 1,
    "hasNextPage": false
  }
}
```