# List tasks

URL: /docs/api/merchant/crm/list-tasks

## GET /v1/merchant/crm/tasks

```http
GET https://api.elaraone.app/api/v1/merchant/crm/tasks
```

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `filter[updated_since]` | query | string |  |  |
| `filter[due_before]` | query | string |  |  |
| `filter[due_after]` | query | string |  |  |
| `filter[custom][]` | query | string[] |  |  |
| `sort` | query | string |  |  |
| `perPage` | query | integer |  |  |
| `cursor` | query | string |  |  |
| `X-Client-IP` | header | string |  | Optional. IP address of the shopper (one IPv4/IPv6, no port, no list). Honoured only together with a valid X-Tenant-Secret; ignored otherwise. Used for rate limits and recorded with form submissions. |
| `X-Tenant-Secret` | header | string |  | Optional here. Server secret of the store: server-to-server only, never from a browser. Enables X-Client-IP. |

### Responses

- **200**: A page of results, with `links` and `meta`.
- **401**: Unauthenticated
- **402**: Payment required. Branch on `error.code`: - `TENANT_PAYMENT_REQUIRED`: this store is on payment hold. Show a "store temporarily unavailable" page; do not retry the request.
- **403**: Authorization error
- **404**: Not found: `FEATURE_NOT_ENABLED` when this store does not have the CRM feature on.
- **422**: Validation error
- **429**: `RATE_LIMITED`: the API budget of the store (per store and caller IP) is spent. Wait for `Retry-After`; a sync job should page with `filter[updated_since]` rather than re-reading everything.