# Get a task

> One task's full brief: why it matters, the steps, the evidence and the topics it moves. Pro and Growth plans.

Source: https://getintel.ai/docs/api/reference/operations/task/

## GET /tasks/{id}

`GET https://app.getintel.ai/api/v1/tasks/{id}`

### Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `id` | path | yes | integer | Task id from GET /tasks. |
| `brand_id` | query | no | integer | The brand to read, from GET /brands. Required when the account has more than one brand. |
| `market` | query | no | string | The market to read, from GET /markets: its code (IN-hi, or just IN) or id. Default: the primary market. |

### Responses

- **200**: OK
- **400**: Invalid parameter, or brand_id missing on a multi-brand account (brand_required). (`Error`)
- **401**: Missing, revoked or unknown API key (invalid_api_key). (`Error`)
- **403**: The plan doesn't include this data (feature_not_in_plan) or the plan isn't active (plan_inactive). (`Error`)
- **404**: The brand or the requested item doesn't exist (brand_not_found, not_found). (`Error`)
- **409**: The integration this needs isn't connected (integration_not_connected). (`Error`)
- **429**: Monthly read limit reached (quota_exceeded) or more than 60 requests a minute (rate_limited). (`Error`)
- **502**: An upstream service failed; retry later (upstream_error). (`Error`)