---
title: "Histórico de faturamentos"
method: GET
path: "/reports/billings/history"
tags: ["Relatórios"]
---

# Histórico de faturamentos

`GET /reports/billings/history`

## Request

- Base URL: `https://api.tiflux.com/api/v2`
- URL: `https://api.tiflux.com/api/v2/reports/billings/history`
- Auth: HTTP bearer

Este método lista os faturamentos realizados, retornando as informações do relatório histórico de faturamentos.

O atributo `contracts` traz os contratos cobrados em cada fatura. Uma fatura pode cobrir mais de um contrato; fatura de grupo de contrato lista o grupo.

## Query parameters

- `offset` integer
- `limit` integer
- `billing_start_date` string, date
- `billing_end_date` string, date
- `due_start_date` string, date
- `due_end_date` string, date
- `client_id` integer
- `nfe_number` integer
- `ticket_number` integer
- `_type` 'billed' | 'reversed' | 'paid'
- `contract_id` integer
- `contract_group_id` integer

## Response `200`

## Other responses

- `403`: ### **Problemas com permissão** Essa resposta significa que o seu usuário está autenticado corretamente, porém, não possui a permissão ou licença necessária para acessar essa rota
- `422`: ### **Problemas com os parâmetros informados**

## Changes

- **2026-10-14** `b081c842364f`: 2 info
  - added the new optional `query` request parameter `contract_group_id`
  - added the new optional `query` request parameter `contract_id`

[Operation history](https://skmtc.dev/tiflux/apis/tiflux-official-api/changes/reports/billings/history/get.md)

---

[API](https://skmtc.dev/tiflux/apis/tiflux-official-api.md) - [All operations](https://skmtc.dev/tiflux/apis/tiflux-official-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tiflux/apis/tiflux-official-api/revisions/2936ac99a76d?raw)