# Project tasks get

> Get all tasks for a project

- Source: https://www.taskade.com/docs/rest/project-tasks-get
- Section: REST API
- Endpoint: `GET /projects/{projectId}/tasks` (API v1)
- Index of all pages: https://www.taskade.com/docs/llms.txt

## GET `/projects/{projectId}/tasks`

Get all tasks for a project

Base URL: `https://www.taskade.com/api/v1`

### Authentication

Send a personal access token or an OAuth 2.0 access token as a bearer token. Create a personal access token at [taskade.com/settings/api](https://www.taskade.com/settings/api).

```http
Authorization: Bearer tskdp_your_token_here
```

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `limit` | query | `number` | No | — |
| `after` | query | `string` | No | Parameter for cursor-based pagination. Specify task ID to get tasks after it. Do not specify both before and after. |
| `before` | query | `string` | No | Parameter for cursor-based pagination. Specify task ID to get tasks before it. Do not specify both before and after. |
| `projectId` | path | `string` | Yes | — |

### Example request

```bash
curl -X GET "https://www.taskade.com/api/v1/projects/<projectId>/tasks" \
  -H "Authorization: Bearer $TASKADE_TOKEN"
```

### Responses

#### `200` — Tasks

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ok` | `boolean` | Yes | — |
| `items` | `Task[]` | Yes | — |
| `items[].id` | `string` | Yes | — |
| `items[].text` | `string` | No | — |
| `items[].parentId` | `string` | No | — |
| `items[].completed` | `boolean` | No | — |
| `hasMore` | `boolean` | Yes | Whether more tasks exist after this page. Pass `nextCursor` as `after` to fetch them. |
| `nextCursor` | `string` | Yes | Task ID to pass as the `after` cursor to fetch the next page, or null if this is the last page. |

A nested field marked Yes is required whenever its parent object is present.

#### `4XX` — Error description

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ok` | `boolean` | Yes | — |
| `message` | `string` | Yes | — |
| `code` | `string` | Yes | — |
| `statusMessage` | `string` | Yes | — |
| `featureId` | `string` | No | The plan entitlement the request needs, set on some PAYMENT_REQUIRED errors. |

### Errors

Errors return an `ok: false` envelope. Rate limiting returns `429` with `x-rate-limit-limit`, `x-rate-limit-remaining` and `x-rate-limit-reset` headers. `x-rate-limit-reset` is the number of seconds until the window reopens. `Retry-After` is not sent, so schedule retries from `x-rate-limit-reset`; retrying sooner will fail again.

```json
{ "ok": false, "message": "Unauthorized", "code": "UNAUTHORIZED" }
```

Rate limits for this version: enforced per endpoint; ceilings are not published and can change without notice. A `429` response carries `x-rate-limit-limit`, `x-rate-limit-remaining`, and `x-rate-limit-reset` (seconds until the window reopens). Back off from those headers rather than hardcoding numbers. Bundle import and export run under tighter limits than regular reads and writes, so schedule bulk transfers accordingly. See [Rate limits](https://www.taskade.com/docs/getting-started/rest-api-guide#rate-limits).