---
title: "Lista faturas de cartão de crédito"
method: GET
path: "/api/v1/credit-card-bills"
tags: ["Cartão de crédito"]
---

# Lista faturas de cartão de crédito

`GET /api/v1/credit-card-bills`

## Request

- Base URL: `https://snabber.com.br`
- URL: `https://snabber.com.br/api/v1/credit-card-bills`
- Auth: HTTP bearer

Retorna as faturas reais que o emissor do cartão reportou via Open Finance (`credit_card_bills`), com o valor total cobrado, datas de fechamento/vencimento, pagamento mínimo, encargos e situação de pagamento. Cada fatura é identificada pelo mês de vencimento (`cycle_month`, YYYY-MM). Só aparecem cartões sincronizados via Open Finance e meses dentro da janela que o banco disponibiliza — cartões manuais não têm fatura real; para esses, use `/api/v1/credit-card-bills/invoice`, que cai na estimativa local. A conta pode ser informada por `account_id` ou pelo nome em `account`; se omitida, traz todos os cartões do workspace.

## Query parameters

- `workspace_id` integer
- `account_id` integer
- `account` string
- `from_month` string
- `to_month` string

## Response `200`

Lista de faturas

- CreditCardBillList
  - `data` CreditCardBill[]
    - `id` string: Identificador da fatura na instituição. Casa com `bill_id` das transações em /v1/transactions — é o vínculo transação↔fatura mais confiável. Opaco: não presuma formato
    - `account_id` integer
    - `account` string
    - `cycle_month` string: Mês de vencimento — a chave que identifica a fatura
    - `closing_month` string: Mês de FECHAMENTO do ciclo ("YYYY-MM"). Casa com `bill_forecast_date` das transações. Distinto de `cycle_month` (vencimento): quando o dia de vencimento é anterior ao de fechamento, o vencimento cai no mês seguinte
    - `due_date` string, date, nullable
    - `closing_date` string, date, nullable: null enquanto a fatura não fechou
    - `is_closed` boolean
    - `total_amount` number, nullable: Valor total cobrado pelo emissor
    - `currency_code` string, nullable
    - `minimum_payment_amount` number, nullable
    - `finance_charges_total` number, nullable: Soma dos encargos/juros reportados
    - `allows_installments` boolean, nullable
    - `payment_status` 'paid' | 'partial' | 'open' | 'due' | 'no_charge' | 'unknown' | 'null', nullable: paid = quitada, partial = paga parcialmente, open = ainda aberta, due = fechada e a vencer, no_charge = sem cobrança, unknown = sem evidência de pagamento
    - `paid_amount` number, nullable
    - `paid_at` string, date, nullable
    - `payment_mode` string, nullable
    - `payment_value_type` string, nullable
  - `pagination` Pagination
    - `limit` integer
    - `has_more` boolean
    - `next_cursor` string, nullable
  - `meta` object
    - `workspace_id` integer

## Other responses

- `400`: Parâmetro inválido
- `401`: Chave de API ausente, inválida, revogada ou expirada
- `403`: Plano do usuário não tem acesso à API (downgrade para free)
- `404`: Conta não encontrada neste workspace
- `429`: Limite de requisições excedido

---

[API](https://skmtc.dev/snabber/apis/snabber-api.md) · [All operations](https://skmtc.dev/snabber/apis/snabber-api/llms.txt) · [OpenAPI document](https://skmtc.dev/snabber/apis/snabber-api/revisions/bf5841cbd8ce?raw)