---
title: "GET /tools/api/get-bill-summary"
method: GET
path: "/tools/api/get-bill-summary"
tags: ["Bills"]
---

# GET /tools/api/get-bill-summary

`GET /tools/api/get-bill-summary`

Retorna o resumo da fatura atual do(s) cartão(ões) de crédito do usuário: limite total, limite disponível, período considerado e o valor aproximado da fatura. Requer API key para autenticação e assinatura ativa.

## Query parameters

- `accountId` string
- `closingDay` integer
- `startDate` string, date-time
- `endDate` string, date-time

## Response `200`

Resumo da fatura corrente

- object
  - `success` boolean — Indica se a requisição foi bem-sucedida
  - `data` BillSummary[] — Resumo da fatura corrente de cartão de crédito
    - unknown
  - `recommendations` string, nullable — Mensagens com recomendações (ex.: ausência de closingDay e sugestão de uso do manage-closing-date)
  - `transactionsInfo` string — Informação sobre o número de transações consideradas no cálculo
  - `notice` string — Aviso sobre valor aproximado e possíveis atrasos de sincronização
  - `guidance` string — Orientação para usar get-bills em casos de faturas já fechadas/vencidas
  - `filters` object — Filtros aplicados na consulta (ex.: accountId, closingDay, startDate, endDate)
    - `accountId` string, nullable — ID da conta filtrada
    - `closingDay` integer, nullable — Dia de fechamento usado
    - `startDate` string, date-time, nullable — Data de início do período
    - `endDate` string, date-time, nullable — Data de fim do período
  - `timestamp` string, date-time — Timestamp da requisição em formato ISO 8601

## Other responses

- `401` — Authentication or subscription error
- `500` — Internal server error

---

[API](https://skmtc.dev/pierre/apis/pierre-finance-api.md) · [All operations](https://skmtc.dev/pierre/apis/pierre-finance-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pierre/pierre-finance-api/revisions/caa3b50e534e/schema)