---
title: "List Jobs"
method: GET
path: "/api/v1/async/jobs"
tags: ["Async Scraping"]
---

# List Jobs

`GET /api/v1/async/jobs`

## Request

- Base URL: `https://api.finedata.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.finedata.ai/api/v1/async/jobs`
- Auth: HTTP bearer

List your async jobs, newest first. Supports pagination and status filtering.

## Query parameters

- `limit` integer: Max jobs to return
- `offset` integer: Offset for pagination
- `status` string, nullable: Filter by status: pending, processing, completed, failed, cancelled

## Headers

- `authorization` string, nullable
- `x-api-key` string, nullable

## Response `200`

Successful Response

- AsyncJobListResponse: Paginated list of async jobs.
  - `jobs` unknown[], required
    - unknown
  - `total` integer, required: Total number of jobs
  - `limit` integer, required: Page size
  - `offset` integer, required: Current offset

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/finedata/apis/finedata-api.md) · [All operations](https://skmtc.dev/finedata/apis/finedata-api/llms.txt) · [OpenAPI document](https://skmtc.dev/finedata/apis/finedata-api/revisions/d4321b98fd0e?raw)