# List consents (/data-api/api-reference/v1/list-consents)

List consents belonging to a client.

## GET /consent

**List consents**

List consents belonging to a client.

**Tags:** consent, v3

### Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `end_user_id` | query | string | No | The ID of the end user to list consents for. |
| `active` | query | boolean | No | Filter to include only active or inactive consents. |
| `expires_before` | query | string | No | Optional RFC3339 timestamp. Only consents expiring before this time are returned. |
| `page[before]` | query | string | No | When page[before] is specified, backwards pagination is achieved. |
| `page[after]` | query | string | No | When page[after] is specified, forwards pagination is achieved. |
| `page[size]` | query | integer | No | When page[size] is specified, no more than page[size] resources will be included in the response. It is capped at 1000. |

### Responses

**200:** OK

| Field | Type | Description |
|-------|------|-------------|
| `consents` | server.ConsentResponse[] | A list of consents belonging to the client. |
| `links` | object | Links to be used for pagination. |

**400:** Bad Request

| Field | Type | Description |
|-------|------|-------------|
| `id` | string | Unique identifier for this error. |
| `message` | string | Details about the error that occurred. |
| `name` | string | The name of the error. |

**500:** Internal Server Error

| Field | Type | Description |
|-------|------|-------------|
| `id` | string | Unique identifier for this error. |
| `message` | string | Details about the error that occurred. |
| `name` | string | The name of the error. |

### Example Request
```bash
curl -X GET "https://api.fiskil.com/consent" \
  -H "Authorization: Bearer YOUR_TOKEN"
```