Cartão de crédito

Lista faturas de cartão de crédito

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.

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

Query parameters

workspace_idinteger

Workspace a consultar, entre os autorizados para esta chave (ver GET /api/v1/workspaces). Se omitido, usa o workspace padrão da chave. Um id fora do conjunto autorizado resulta em 400 INVALID_WORKSPACE. Só é possível autorizar (em /integrations) um workspace do qual o dono da chave já é membro — para incluir dados de um workspace de outra pessoa, ela precisa primeiro compartilhar esse workspace com você (convite em /workspaces), não basta saber o id.

account_idinteger

Id da conta de cartão de crédito (ver /api/v1/accounts)

accountstring

Nome exato da conta, alternativa a account_id

from_monthstring

Example:2026-01

Mês de vencimento inicial (inclusivo), YYYY-MM

to_monthstring

Example:2026-06

Mês de vencimento final (inclusivo), YYYY-MM

Response

Lista de faturas

Example response

{
  "data": [
    {
      "id": "a3f1c0de-9b2e-4d77-8f10-2c5e1b7a4d90",
      "account": "Nubank",
      "cycle_month": "2026-06",
      "closing_month": "2026-05",
      "total_amount": 1847.32,
      "currency_code": "BRL"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.