> ## Documentation Index
> Fetch the complete documentation index at: https://docs.delfinance.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar repasses

> Liste os repasses da conta de recebimento, com filtros por beneficiário, status e data do repasse.

> [!WARNING]
>
> **Funcionalidade em beta.** Contrato em proposta, sujeito a mudanças. Veja o guia [Acompanhar repasses](https://docs.delfinance.com.br/guias/split-pagamentos/acompanhar-repasses.md).

Retorna, de forma paginada, os repasses de todos os recebimentos com split da conta de recebimento. Use o filtro `beneficiaryDocument` para mostrar a um beneficiário o histórico dos repasses dele.

## Headers

**x-delbank-api-key** `string` *required*

Sua API key.

**x-delfinance-account-id** `string` *required*

Número da conta de recebimento.

## Query params

**beneficiaryDocument** `string`

CPF ou CNPJ do beneficiário, somente números.

**status** `string`

Status do repasse: `SCHEDULED`, `PENDING`, `PROCESSING`, `PAID`, `FAILED` ou `CANCELED`.

**transferType** `string`

Forma do repasse: `INTERNAL` ou `PIX_MANUAL`.

**paymentDateFrom** `string`

Data inicial do repasse, no formato `YYYY-MM-DD`.

**paymentDateTo** `string`

Data final do repasse, no formato `YYYY-MM-DD`.

**page** `number` (default: 1)

Número da página (começa em 1).

**limit** `number` (default: 20)

Itens por página. Máximo de 100.

## Response

Array de repasses. Os dados de paginação vêm no header `Pagination`, descrito em [Paginação](#paginação).

**id** `string`

Identificador do repasse. Use-o para [cancelar o repasse](https://docs.delfinance.com.br/api-reference/split-pagamentos/cancelar-repasse.md).

**order** `object`

Recebimento com split que gerou o repasse. Mostra o valor integral do pagamento, a origem das instruções e a base de cálculo, sem precisar de outra consulta. É o mesmo recurso retornado por [Consultar recebimento com split](https://docs.delfinance.com.br/api-reference/split-pagamentos/consultar-recebimento.md).

**order**

**id** `string`

Identificador do recebimento com split: o id da transação de crédito, o mesmo do extrato e do webhook de recebimento. Use-o em [Consultar recebimento com split](https://docs.delfinance.com.br/api-reference/split-pagamentos/consultar-recebimento.md).

**source** `string`

`ACCOUNT_CONFIGURATION` (split padrão da conta) ou `QR_CODE` (split por cobrança).

**grossAmount** `number`

Valor integral do pagamento recebido.

**tariffAmount** `number`

Tarifa de split descontada antes do cálculo. `0` quando não há.

**splitBaseAmount** `number`

Base de cálculo dos repasses (`grossAmount - tariffAmount`).

**createdAt** `string`

Data e hora do recebimento, em ISO 8601.

**status** `string`

`SCHEDULED`, `PENDING`, `PROCESSING`, `PAID`, `FAILED` ou `CANCELED`. Veja o significado de cada um em [Status do repasse](https://docs.delfinance.com.br/guias/split-pagamentos/acompanhar-repasses.md#status-do-repasse).

**transferType** `string`

`INTERNAL` ou `PIX_MANUAL`.

**instructionType** `string`

Tipo da instrução que gerou o repasse: `PERCENTAGE` ou `FIXED`.

**instructionAmount** `number`

Percentual ou valor definido na instrução.

**amount** `number`

Valor calculado do repasse, em reais.

**paymentDate** `string`

Data prevista do repasse, no formato `YYYY-MM-DD`. Nesta fase, é sempre a data do recebimento.

**beneficiary** `object`

Conta do beneficiário, no mesmo formato usado nas transferências.

**beneficiary**

**number** `string`

Número da conta do beneficiário.

**branch** `string`

Agência da conta do beneficiário.

**type** `string`

Tipo da conta do beneficiário: `PAYMENT`, `CURRENT` ou `SAVING`.

**holder** `object`

Titular da conta, ou seja, o beneficiário.

**holder**

**document** `string`

CPF ou CNPJ do beneficiário.

**name** `string`

Nome do beneficiário.

**type** `string`

`NATURAL` (pessoa física) ou `LEGAL` (pessoa jurídica).

**participant** `object`

Instituição da conta do beneficiário.

**participant**

**ispb** `string`

ISPB da instituição.

**name** `string`

Nome da instituição.

**executedTransactionId** `string`

Id da transferência que executou o repasse (transferência interna ou Pix). `null` enquanto o repasse não é executado.

**endToEndId** `string`

Identificador do Pix, em repasses `PIX_MANUAL`.

**failureReason** `string`

Motivo da falha, quando o status é `FAILED`.

**paidAt** `string`

Data e hora em que o repasse foi pago, em ISO 8601.

**canceledAt** `string`

Data e hora do cancelamento, em ISO 8601.

**cancelReason** `string`

Motivo informado no cancelamento.

**createdAt** `string`

Data e hora de criação do repasse, em ISO 8601.

**updatedAt** `string`

Data e hora da última mudança de status, em ISO 8601.

## Paginação

A resposta é um array. Os dados de paginação vêm no header `Pagination`:

```text Header theme={null}
Pagination: {"currentPage":1,"pageSize":20,"pageCount":1,"rowCount":1,"totalAmount":5.00}
```

| Campo | Descrição |
| - | - |
| `currentPage` | Página retornada |
| `pageSize` | Itens por página (`limit`) |
| `pageCount` | Total de páginas |
| `rowCount` | Total de repasses encontrados |
| `totalAmount` | Soma do `amount` de todos os repasses encontrados, considerando todas as páginas |

```bash cURL theme={null}
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/split-payments/payouts?beneficiaryDocument=12345678909&status=FAILED&paymentDateFrom=2026-10-01&paymentDateTo=2026-10-26' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}'
```

```json 200 theme={null}
[
    {
        "id": "5d2e8f1a-7c3b-4e9d-a6f0-1b2c3d4e5f60",
        "order": {
            "id": "b4c5d6e7-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
            "source": "QR_CODE",
            "grossAmount": 50.00,
            "tariffAmount": 0.00,
            "splitBaseAmount": 50.00,
            "createdAt": "2026-10-20T10:15:00.000Z"
        },
        "status": "FAILED",
        "transferType": "PIX_MANUAL",
        "instructionType": "FIXED",
        "instructionAmount": 5.00,
        "amount": 5.00,
        "paymentDate": "2026-10-20",
        "beneficiary": {
            "number": "123456",
            "branch": "0001",
            "type": "CURRENT",
            "holder": {
                "document": "12345678909",
                "name": "MARIA SOUZA",
                "type": "NATURAL"
            },
            "participant": {
                "ispb": "00000000",
                "name": "BANCO EXEMPLO S.A."
            }
        },
        "executedTransactionId": "c9d8e7f6-a5b4-4c3d-9e2f-1a0b9c8d7e6f",
        "endToEndId": "E00000000202610201015fedcba654321",
        "failureReason": "Conta do beneficiário inexistente ou encerrada",
        "paidAt": null,
        "canceledAt": null,
        "cancelReason": null,
        "createdAt": "2026-10-20T10:15:02.000Z",
        "updatedAt": "2026-10-20T10:15:09.000Z"
    }
]
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.