AI resources
List consents

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

GET

https://api.mercadopago.com/v1/split-consent
Request parameters
Header
Authorization
string

REQUIRED

Access Token obtained through the developer panel. Must be sent in all requests.
Query
status
string
Filters consents by status. Possible values: PENDING, ACTIVE, REJECTED, CANCELED, EXPIRED.
receiver_id
string
Filters consents by the unique identifier of the secondary seller (UUID).
offset
integer
Number of records to skip from the beginning. Used for pagination.
limit
integer
Maximum number of records to return per page.
Response parameters
paging
object

REQUIRED

results
array
List of consents.
Errors

400Bad request. Check the parameters sent. The errors field in the response contains the detail of the failing parameter.

401Unauthorized. The Access Token is invalid, expired, or missing from the Authorization header.

500Internal server error. If the error persists, contact Mercado Pago developer support.

Request
curl -X GET \
    'https://api.mercadopago.com/v1/split-consent?status=PENDING&receiver_id=550e8400-e29b-41d4-a716-446655440001&limit=10'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-8*********88776-122*********fc20dede6*********a497d7225*********64' \
    
Response
{
  "paging": {
    "total": 100,
    "offset": 0,
    "limit": 10
  },
  "results": [
    {
      "receiver_id": "550e8400-e29b-41d4-a716-446655440001",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-16T08:00:00Z"
    }
  ]
}