# Listar boletos do DDA

**Área:** DDA

Lista os boletos registrados no CPF/CNPJ da conta. Exige inscrição em `ACTIVE`, `INACTIVATING` ou `INACTIVATE_FAILED`.

`GET /v1/dda/invoices`

**Base URL Produção:** `https://api.validapay.com.br`  
**Base URL Sandbox:** `https://sandbox.validapay.com.br`

**Scopes necessários:** `dda/read`

### Query parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `status` | não | OPEN, PAID ou CANCELLED |
| `startDate` | não | filtra por vencimento (ISO 8601) |
| `endDate` | não | filtra por vencimento (ISO 8601) |
| `limit` | não | 1-100, default 50 |
| `lastKey` | não | cursor devolvido em pagination.lastKey |

### Resposta 200: Sucesso

```json
{
    "items": [
        {
            "accountNumber": "460851686",
            "documentNumber": "12345678901",
            "barCode": "23790000000000297500000000000000000000000000",
            "digitableLine": "23790000000000000000000000000000000000000000000",
            "payer": {
                "documentNumber": "12345678901",
                "name": "Maria Souza",
                "personType": "F"
            },
            "beneficiary": {
                "documentNumber": "37536531000103",
                "name": "Fornecedor Exemplo LTDA",
                "fantasyName": "Fornecedor Exemplo",
                "personType": "J"
            },
            "description": "Fixed DueDate",
            "amount": 29.75,
            "dueDate": "2026-10-14T00:00:00Z",
            "registrationDate": "2026-10-01T00:00:00Z",
            "overdueDate": "2026-11-14T00:00:00Z",
            "status": "OPEN",
            "interest": {
                "code": 5,
                "description": "Exempt",
                "amount": 0
            },
            "fine": {
                "code": 3,
                "description": "Exempt",
                "amount": 0
            },
            "discounts": [],
            "createdAt": "2026-10-07T12:32:37.043Z",
            "updatedAt": "2026-10-07T12:32:37.043Z"
        }
    ],
    "pagination": {
        "total": 63,
        "totalPages": 2,
        "limit": 50,
        "hasMore": true,
        "lastKey": "eyJQSyI6IkFDQ09VTlQjNDYwODUxNjg2In0="
    }
}
```


### Resposta 403: DDA não ativo

```json
{
    "error": {
        "message": "Ative o DDA para ver os boletos",
        "code": "DDA_SUBSCRIPTION_NOT_ACTIVE",
        "details": null,
        "timestamp": "2026-10-07T12:32:37.043Z"
    }
}
```


### Resposta 400: Cursor inválido

```json
{
    "error": {
        "message": "lastKey invalido",
        "code": "INVALID_CURSOR",
        "details": null,
        "timestamp": "2026-10-07T12:32:37.043Z"
    }
}
```


### Resposta 403: Indisponível em sandbox

```json
{
    "error": {
        "message": "Não disponível em ambiente de Sandbox",
        "code": "DDA_NOT_AVAILABLE_IN_SANDBOX",
        "details": null,
        "timestamp": "2026-10-07T12:32:37.043Z"
    }
}
```


---

Página: https://docs.validapay.com.br/referencia/get-listar-boletos-do-dda  
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json