> ## Documentation Index
> Fetch the complete documentation index at: https://www.hirebase.org/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Tasks

> List your tasks, newest first, with their state and results.

Returns the tasks created with your API key, newest first, each in the same
shape as [Get Task Status](https://www.hirebase.org/docs/api-reference/tasks/get-task-status.md) (including
`result` once finished). Use it to follow a whole batch with one request
instead of polling each task.

Task reads have their own rate limit of **600 requests per minute** per key,
separate from the 100 per minute shared by every other endpoint.

## Endpoint

```bash theme={null}
GET /v2/tasks/
```

## Query Parameters

**task\_type** `string`

Only tasks of this type, e.g. `contacts_extraction`. See the `type` values on
[Get Task Status](https://www.hirebase.org/docs/api-reference/tasks/get-task-status.md#response).

**state** `string`

Only tasks in this state: `queued`, `processing`, `finished`, `failed`, or `canceled`.

**limit** `integer` (default: 100)

How many tasks to return, 1 to 1,000.

**skip** `integer` (default: 0)

How many tasks to skip, for paging through older ones.

## Response

An array of task objects, newest first. See [Get Task Status](https://www.hirebase.org/docs/api-reference/tasks/get-task-status.md#response) for the fields.

## Example

```bash cURL theme={null}
curl -X GET "https://api.hirebase.org/v2/tasks/?task_type=contacts_extraction&state=finished&limit=200" \
  -H "x-api-key: YOUR_API_KEY"
```

## Error Responses

> **401 Unauthorized**
>
> Missing or invalid API key.

> **422 Unprocessable Entity**
>
> Unknown `task_type` or `state`, or `limit` outside 1 to 1,000.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.