GET/pix-biometric/enrollments

List enrollments

Lists the accounts your payers linked for Pix por biometria. A payer can have several: one per device and browser, and one per institution.

Parameters

Query Parameters

Name	Type	Description
`customerId`	string (uuid)	Enrollments created in payment requests for this Payment Customer
`cpf`	string	Payer's CPF, digits only
`cnpj`	string	Payer's CNPJ, digits only
`status`	string	Enrollment status `CREATEDAUTHORIZEDREJECTEDREVOKEDEXPIRED`
`page`	integer	Page number
`pageSize`	integer	Page size

Responses

200The enrollments

object

pagenumber (double)

totalnumber (double)

totalPagesnumber (double)

resultsobject[]

List of enrollments

itemsobject

A linked account (enrollment): the payer's account at one institution, linked to the device and browser where they created the passkey. Only the payer creates one, on the payment page.

Example response

json

{
  "page": 1,
  "total": 1,
  "totalPages": 1,
  "results": [
    {
      "id": "c91a5e2b-7d0f-4f3e-9a51-2f6b8e1d4c77",
      "status": "AUTHORIZED",
      "connector": {
        "id": 608,
        "name": "Santander",
        "imageUrl": "https://cdn.pluggy.ai/assets/connector-icons/208.svg"
      },
      "debtor": {
        "name": "John Doe",
        "taxNumber": "***.456.789-**",
        "bankAccount": {
          "agency": "1234",
          "account": "****4821",
          "name": "Santander"
        }
      },
      "cpf": "***.456.789-**",
      "cnpj": null,
      "customerId": "a2d4c1e8-5b7f-4c3a-9e2d-1f6b8c0d7e55",
      "limits": {
        "transaction": 1000,
        "daily": 3000,
        "dailyUsed": 149.9
      },
      "expiresAt": "2027-10-28T13:05:00.000Z",
      "dataConsent": null,
      "revokedBy": null,
      "errorDetail": null,
      "createdAt": "2026-10-28T13:02:00.000Z",
      "updatedAt": "2026-10-28T13:05:00.000Z"
    }
  ]
}

curl -X GET \
  'https://api.pluggy.ai/pix-biometric/enrollments' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY'

Sample response

{
  "page": 1,
  "total": 1,
  "totalPages": 1,
  "results": [
    {
      "id": "c91a5e2b-7d0f-4f3e-9a51-2f6b8e1d4c77",
      "status": "AUTHORIZED",
      "connector": {
        "id": 608,
        "name": "Santander",
        "imageUrl": "https://cdn.pluggy.ai/assets/connector-icons/208.svg"
      },
      "debtor": {
        "name": "John Doe",
        "taxNumber": "***.456.789-**",
        "bankAccount": {
          "agency": "1234",
          "account": "****4821",
          "name": "Santander"
        }
      },
      "cpf": "***.456.789-**",
      "cnpj": null,
      "customerId": "a2d4c1e8-5b7f-4c3a-9e2d-1f6b8c0d7e55",
      "limits": {
        "transaction": 1000,
        "daily": 3000,
        "dailyUsed": 149.9
      },
      "expiresAt": "2027-10-28T13:05:00.000Z",
      "dataConsent": null,
      "revokedBy": null,
      "errorDetail": null,
      "createdAt": "2026-10-28T13:02:00.000Z",
      "updatedAt": "2026-10-28T13:05:00.000Z"
    }
  ]
}