# List consents

Returns the list of consents for the primary seller with pagination support. You can filter by status or by `receiver_id`.

**GET** `/v1/split-consent`

## Request parameters

### Query

- `status` (string, optional)
  Filters consents by status. Possible values: PENDING, ACTIVE, REJECTED, CANCELED, EXPIRED.

- `receiver_id` (string, optional)
  Filters consents by the unique identifier of the secondary seller (UUID).

- `offset` (integer, optional)
  Number of records to skip from the beginning. Used for pagination.

- `limit` (integer, optional)
  Maximum number of records to return per page.

## Response parameters

- `paging` (object, required)

  - `paging.total` (integer, required)
  Total number of available records.

  - `paging.offset` (integer, required)
  Number of records skipped from the beginning.

  - `paging.limit` (integer, required)
  Maximum number of records returned.

- `results` (array, required)
  List of consents.

  - `results[].receiver_id` (string, required)
  Unique consent identifier in UUID format.

  - `results[].status` (string, required)
  Current status of the consent.
Possible enum values:

  - `PENDING`
  The secondary seller received the invitation but has not yet accepted or rejected it.

  - `ACTIVE`
  The secondary seller accepted the consent. Split payments are enabled.

  - `REJECTED`
  The secondary seller rejected the invitation.

  - `CANCELED`
  The primary seller canceled the consent.

  - `EXPIRED`
  The invitation expired without a response within the established deadline.

  - `results[].created_at` (string, required)
  Consent creation date and time (ISO 8601).

  - `results[].updated_at` (string, optional)
  Last consent update date and time (ISO 8601).

## Errors

| Status | Error | Description |
| ------- | ------- | ----------- |
| 400 | — | Bad request. Check the parameters sent. The `errors` field in the response contains the detail of the failing parameter. |
| 401 | — | Unauthorized. The Access Token is invalid, expired, or missing from the Authorization header. |
| 500 | — | Internal server error. If the error persists, contact Mercado Pago developer support. |

## Request example

### cURL

```bash
curl -X GET \
  'https://api.mercadopago.com/v1/split-consent?status=<STATUS>&receiver_id=<RECEIVER_ID>&offset=<OFFSET>&limit=<LIMIT>' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>'
```

## Response example

```json
{
  "paging": {
  "total": 100,
  "offset": 0,
  "limit": 10
  },
  "results": [
  {
  "receiver_id": "550e8400-e29b-41d4-a716-446655440001",
  "status": "PENDING",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-16T08:00:00Z"
  }
  ]
}
```