---
title: "List"
method: GET
path: "/payments/recipients"
tags: ["Payment Recipient"]
---

# List

`GET /payments/recipients`

Recovers all created payment recipients

## Query parameters

- `pageSize` number, double
- `page` number, double
- `isDefault` boolean
- `pixKey` string
- `name` string
- `taxNumber` string

## Response `200`

Retrieve a list of all payment recipients

- object
  - `page` number, double
  - `total` number, double
  - `totalPages` number, double
  - `results` PaymentRecipient[] — List of payment recipients
    - `type` 'BANK_ACCOUNT', required — Recipient discriminator. Always `BANK_ACCOUNT` for this schema.
    - `id` string, required — Primary identifier
    - `taxNumber` string, required — Account owner tax number. Can be CPF or CNPJ (only numbers).
    - `name` string, required — Account owner name.
    - `paymentInstitution` PaymentInstitution, required — Response with information related to a payment institution
      - `id` string, required — Primary identifier
      - `name` string, required — Payment institution name
      - `tradeName` string, required — Payment institution trade name
      - `ispb` string, required — Payment institution ISPB
      - `compe` string — Payment institution COMPE
      - `createdAt` string, date-time, required — Date when the payment institution was created
      - `updatedAt` string, date-time, required — Date when the payment institution was updated
    - `isDefault` boolean, required — Indicates if the recipient is the default one
    - `account` PaymentRecipientAccount, required — Payment receiver bank account information
      - `branch` string, required — Receiver bank account branch (agency)
      - `number` string, required — Receiver bank account number
      - `type` string, required — Receiver bank account type, could be: 'CHECKING_ACCOUNT', 'SAVINGS_ACCOUNT' or 'GUARANTEED_ACCOUNT'
    - `pixKey` string — Pix key associated with the payment recipient
    - `createdAt` string, date-time, required — Date when the payment recipient was created
    - `updatedAt` string, date-time, required — Date when the payment recipient was last updated

---

[API](https://skmtc.dev/pluggy/apis/pluggy-api.md) · [All operations](https://skmtc.dev/pluggy/apis/pluggy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pluggy/pluggy-api/revisions/75e87ec7f9cd/schema)