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

# GET /tools/api/get-bills

`GET /tools/api/get-bills`

Retorna faturas de cartão de crédito vencidas (apenas faturas já fechadas e com vencimento passado) do usuário autenticado. Requer API key para autenticação e assinatura ativa.

## Query parameters

- `accountId` string

## Response `200`

Lista de faturas de cartão de crédito vencidas

- object
  - `success` boolean — Indica se a requisição foi bem-sucedida
  - `data` Bill[] — Lista de faturas de cartão de crédito vencidas
    - unknown
  - `count` number — Número de faturas retornadas
  - `filters` object — Filtros aplicados na consulta
    - `accountId` string, nullable — ID da conta filtrada (null se não especificado)
    - `onlyPastDue` boolean — Indica que apenas faturas vencidas são retornadas
  - `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)