> ## 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 autorizações

> Lista as autorizações de Pix Automático da conta, do lado do pagador ou do recebedor.

> [!NOTE]
>
> Para o passo a passo completo, veja o guia [Consultar autorizações e agendamentos](https://docs.delfinance.com.br/guias/pix/pix-automatico/consultar.md).

## Headers

**Authorization** `string` *required*

Sua API key, sem o prefixo `Bearer`.

## Query params

**flow** `number` *required*

Lado da consulta: `0` pagador, `1` recebedor.

**status** `string`

`PROCESSING`, `SUCCESS`, `CANCELLED` ou `PROCESSING_ERROR`. Diferencia maiúsculas de minúsculas.

**authorizationResult** `string`

Resultado da autorização, como `PENDING_USER` ou `ACCEPTED`.

**beneficiaryDocument** `string`

CNPJ do recebedor.

**beneficiaryAccount** `string`

Conta do recebedor.

**payerDocument** `string`

CPF ou CNPJ do pagador.

**payerPersonType** `number`

`0` pessoa física, `1` pessoa jurídica.

**payerAgencyNumber** `string`

Agência do pagador, até 4 caracteres.

**payerAccountNumber** `string`

Conta do pagador, até 20 caracteres.

**recurrenceStartDateFrom** `string`

Data inicial da recorrência, a partir de (`YYYY-MM-DD`). Use com `recurrenceStartDateTo`.

**recurrenceCreatedDateTimeFrom** `string`

Criação a partir de. Use com `recurrenceCreatedDateTimeTo`.

**recurrenceUpdatedDateTimeFrom** `string`

Última atualização a partir de. Use com `recurrenceUpdatedDateTimeTo`.

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

Página, a partir de 1.

**pageSize** `number` (default: 50)

Itens por página, de 1 a 100.

## Response

Array de autorizações, ordenado pela última atualização. A paginação vem no header `Pagination` (`CurrentPage`, `PageCount`, `PageSize`, `RowCount`). Campos sem valor são omitidos.

**id** `string`

Identificador interno (GUID). Use em [Consultar autorização](https://docs.delfinance.com.br/api-reference/pix-automatico/consultar-autorizacao.md).

**flow** `string`

`PAYER` ou `BENEFICIARY`.

**recurrenceId** `string`

Identificador da recorrência.

**journey** `number`

Jornada de autorização: `1`, `2`, `3` ou `4`.

**frequencyType** `string`

Periodicidade.

**authorizationResult** `string`

`PROCESSING`, `AWAITING_VALIDATION`, `PENDING_USER`, `ACCEPTED`, `REJECTED` ou `CANCELLED`.

**status** `string`

`PROCESSING`, `SUCCESS`, `CANCELLED` ou `PROCESSING_ERROR`.

**beneficiary** `object`

Recebedor: `ispb`, `document` e `name`.

**payer** `object`

Pagador: `ispb`, `type`, `document`, `name`, `agencyNumber`, `accountType`, `accountNumber` e `municipalityIbgeCode`.

**debtor** `object`

Devedor: `type`, `document` e `name`.

**contractNumber** `string`

Identificador do contrato.

**contractDescription** `string`

Descrição do contrato.

**recurrenceStartDate** `string`

Data inicial, `yyyy-MM-dd`.

**recurrenceEndDate** `string`

Data final, `yyyy-MM-dd`.

**recurrenceCreatedAt** `string`

Criação da recorrência, `yyyy-MM-ddTHH:mm:ss`.

**requestCreatedAt** `string`

Envio da solicitação (jornada 1).

**requestExpirationAt** `string`

Expiração da solicitação (jornada 1).

**recurrenceAuthorizedAt** `string`

Data da autorização.

**lastInstructionAt** `string`

Vencimento da última cobrança enviada.

**amount** `number`

Valor fixo.

**minPayerMaxAmount** `number`

Piso do valor máximo.

**payerMaxAmount** `number`

Valor máximo definido pelo pagador. Só aparece no lado pagador.

**reasonRejection** `string`

Motivo da recusa.

```bash cURL theme={null}
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/pix/automatic/authorizations?flow=1&status=SUCCESS&page=1&pageSize=50' \
--header 'Authorization: {{apiKey}}'
```

```json 200 theme={null}
[
    {
        "id": "8f3c2a1e-5b7d-4e9f-a0c1-2d3e4f5a6b7c",
        "flow": "BENEFICIARY",
        "recurrenceId": "RR3822485720261027B7C8D9E0F1A",
        "journey": 1,
        "frequencyType": "MONTHLY",
        "authorizationResult": "ACCEPTED",
        "beneficiary": { "ispb": "38224857", "document": "11222333000181", "name": "SUA EMPRESA LTDA" },
        "payer": { "ispb": "60701190", "type": "NATURAL", "document": "12345678901", "agencyNumber": "1234", "accountNumber": "567890", "municipalityIbgeCode": 0 },
        "contractNumber": "CTR-555001",
        "contractDescription": "Plano Familia",
        "recurrenceStartDate": "2026-12-05",
        "recurrenceCreatedAt": "2026-10-27T14:32:10",
        "recurrenceAuthorizedAt": "2026-10-27T18:05:44",
        "amount": 99.90,
        "status": "SUCCESS"
    }
]
```


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