Consulte boletos gerados de acordo com a data de vencimento

Quais são os requisitos para a utilização desta API?
- Token: possuir um token de acesso válido é essencial. Caso ainda não tenha gerado um, temos um guia detalhado disponível no tópico Fluxos de Autorização e Autenticação.
- Boleto: para que a resposta da API seja preenchida, é recomendável que um boleto tenha sido gerado anteriormente.
Parâmetros da requisição
Parâmetro | Tipo | Descrição |
---|---|---|
start opcional | String | Data início, no formato YYYY-MM-DD Atenção O intervalo de tempo da consulta estará relacionado à data de vencimento da fatura por padrão. Em caso de parâmetro state=PAID, o intervalo de tempo é referente a data de pagamento |
end\ opcional | String | Data final, no formato YYYY-MM-DD |
state\ opcional | String | Descrição dos possíveis estados do boleto |
search\ opcional | String | CPF/CNPJ do destinatário |
page\ opcional | Int | Número da página. Possui valor padrão 1 |
perPage\ opcional | Int | Número de itens por página. Possui o valor padrão 20 e valor máximo de 200 |
Estados dos boletos
Parâmetro | Descrição |
---|---|
CANCELLED | Boletos cancelados |
DRAFT | Boletos em rascunho, um estado intermediário entre criação e registro |
LATE | Boletos com pagamento em atraso, ou seja, após a data de vencimento |
OPEN | Boletos registrados, mas ainda não pagos |
PAID | Boletos que foram pagos com sucesso |
RECURRENCE_DRAFT | Boletos criados com recorrência que nos quais o usuário não deu andamento à criação da cobrança |
Parâmetros da resposta
Parâmetro | Tipo | Descrição |
---|---|---|
totalItems obrigatório | Int | Total de items retornados na lista |
items\ obrigatório | Lista de InvoiceSummary | Lista de objetos contendo informações resumidas sobre Invoices |
Dicas de implementação

Premissas
O parâmetro start e o parâmetro end são usados para especificar o intervalo de tempo desejado na consulta. É importante notar que as datas inseridas no parâmetro end devem ser maiores que as datas informadas no parâmetro startErros Comuns
Código de erro | Descrição |
---|---|
401 (Unauthorized) | O token de acesso está inválido ou expirado. Erro comum no momento de trocas de ambientes (Stage/Production) |
400 (Bad Request) | Requisição mal formatada. Alguns exemplos comuns:
|