List Jobs
GET /api/v1/jobs/
List all extraction jobs for your organization. Results are paginated.
Authentication
Requires an API key with jobs:read scope. Pass via the X-API-Key header.
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
page | integer | 1 | Page number. |
page_size | integer | 20 | Number of results per page. Maximum: 100. |
Response
Status: 200 OK
{
"count": 42,
"next": "https://api.parsifyhq.com/api/v1/jobs/?page=2",
"previous": null,
"results": [
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"status": "completed",
"document_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"created_at": "2026-03-16T12:00:00Z",
"updated_at": "2026-03-16T12:05:00Z"
}
]
}Response Fields
| Field | Type | Description |
|---|---|---|
count | integer | Total number of jobs. |
next | string | null | URL for the next page of results. |
previous | string | null | URL for the previous page of results. |
results | array | List of ExtractionJob objects. |
results[].id | string (UUID) | Unique identifier for the job. |
results[].status | string | Current job status: pending, processing, completed, or failed. |
results[].document_id | string (UUID) | The document being processed. |
results[].created_at | string (ISO 8601) | Timestamp when the job was created. |
results[].updated_at | string (ISO 8601) | Timestamp when the job was last updated. |
Errors
| Status | Description |
|---|---|
401 | Missing or invalid API key. |
403 | API key does not have jobs:read scope. |
Code Examples
curl https://api.parsifyhq.com/api/v1/jobs/ \
-H "X-API-Key: YOUR_API_KEY"