---
title: "Consulta de fatura por período"
method: GET
path: "/cards/invoices/document/{documentNumber}/proxy/{proxy}"
tags: ["Consulta de faturas"]
---

# Consulta de fatura por período

`GET /cards/invoices/document/{documentNumber}/proxy/{proxy}`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/cards/invoices/document/{documentNumber}/proxy/{proxy}`
- Auth: HTTP bearer

<div class="bkly-ref-description">
  <p>Consulte todas as faturas de um determinado período (<code>initialDate</code> e <code>finalDate</code>), independentemente do seu <i>status</i>.</p> 
  <span class="bkly-ref-small-stable-tag">stable</span> <span class="bkly-ref-scope-tag">scope: invoice.read</span>
</div>
[block:callout]
{
  "type": "info",
  "title": "Nota",
  "body": "Para mais informações, confira a documentação [Consulta de fatura por período](/docs/consultas-de-faturas)."
}
[/block]

## Path parameters

- `documentNumber` string, nullable, required: Número do documento do titular do cartão.
- `proxy` string, nullable, required: Código identificador do cartão utilizado na transação.

## Query parameters

- `initialDate` string, required: Data inicial, referente ao vencimento da fatura, para a consulta (o período máximo a ser informado entre o <code>initialDate</code> e <code>finalDate</code> deverá ser de um ano). Formato YYYY-MM-DD.
- `finalDate` string, required: Data final, referente ao vencimento da fatura, para a consulta (o período máximo a ser informado entre o <code>initialDate</code> e <code>finalDate</code> deverá ser de um ano). Formato YYYY-MM-DD.

## Parameters

- `#/paths/~1cards~1invoices~1adjustments/post/parameters/1` (unresolved $ref)
- `#/paths/~1cards~1invoices~1adjustments/post/parameters/0` (unresolved $ref)

## Response `200`

Solicitação aceita com sucesso.

- PreviousResumeInvoicesDto
  - `statements` InvoiceResumeDto[], nullable
    - `statementId` integer: Identificador único da fatura.
    - `month` integer: Mês de vencimento da fatura.
    - `year` integer: Ano de vencimento da fatura.
    - `cycle` integer: Indicador do ciclo da fatura (por contrato de crédito).
    - `dueDate` string, date-time: Data de vencimento da fatura.
    - `amountMinimal` number, double: Valor mínimo a ser pago da fatura. Somente é calculado após o fechamento da fatura.
    - `balance` number, double: Valor total da fatura.
    - `cycleType` 'Open' | 'Future' | 'Closed' | 'DueDate': Situação da fatura.
    - `paymentStatus` 'Pending' | 'Paid' | 'PartialPaid': Situação do pagamento da fatura.
    - `paymentTotalAmount` number, double, nullable: Valor pago.

## Other responses

- `400` (unresolved $ref)
- `404` (unresolved $ref)
- `406` (unresolved $ref)

---

[API](https://skmtc.dev/bankly/apis/gest-o-de-faturas.md) - [All operations](https://skmtc.dev/bankly/apis/gest-o-de-faturas/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/gest-o-de-faturas/revisions/59ad0e112fb8?raw)