---
title: "Ciclos de faturamento"
method: GET
path: "/reports/billings/cycles"
tags: ["Relatórios"]
---

# Ciclos de faturamento

`GET /reports/billings/cycles`

## Request

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

Lista os ciclos de faturamento (parcelas) dos contratos e grupos de contrato, com o faturamento que cobrou cada parcela.

Os contratos que compõem um grupo não têm parcelas próprias na resposta: os ciclos são os do grupo.

## Query parameters

- `offset` integer
- `limit` integer
- `contract_id` integer
- `contract_group_id` integer
- `client_id` integer
- `billing_start_date` string, date
- `billing_end_date` string, date
- `_type` 'billed' | 'pending'

## 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`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tiflux/apis/tiflux-official-api/changes/reports/billings/cycles/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)