---
title: "GET /public_api/subscriptions/{id}/billing-cycles/"
method: GET
path: "/public_api/subscriptions/{id}/billing-cycles/"
tags: ["subscriptions"]
---

# GET /public_api/subscriptions/{id}/billing-cycles/

`GET /public_api/subscriptions/{id}/billing-cycles/`

Lista os ciclos de cobrança de uma assinatura

## Path parameters

- `id` string, uuid, required

## Response `200`

Corpo da resposta status 200

- PaginatedBillingCycleList
  - `count` integer, required — Total de resultados
  - `next` string, uri, nullable — URL da próxima página
  - `previous` string, uri, nullable — URL da página anterior
  - `results` BillingCycle[], required — Lista de ciclos de cobrança
    - `id` string, uuid, required — ID do ciclo de cobrança
    - `cycle_number` integer, required — Número do ciclo
    - `due_date` string, date-time, required — Data de vencimento
    - `amount` string, required — Valor do ciclo
    - `status` string, required — Status do ciclo (paid, pending, etc.)
    - `total_attempts` integer, required — Total de tentativas de cobrança
    - `completed_at` string, date-time — Data de conclusão
    - `created_at` string, date-time, required — Data de criação
    - `attempts` Attempt[], required — Lista de tentativas de cobrança
      - `id` string, uuid, required — ID da tentativa
      - `attempt_number` integer, required — Número da tentativa
      - `amount` string, required — Valor tentado
      - `result` string, required — Resultado (success ou failure)
      - `failure_reason` string, nullable — Motivo da falha, se houver
      - `scheduled_for` string, date-time, required — Data agendada
      - `started_at` string, date-time, required — Data de início
      - `completed_at` string, date-time, required — Data de conclusão
      - `created_at` string, date-time, required — Data de criação

## Other responses

- `401` — Request não autenticado devido à ausência ou invalidez do token.
- `404` — Assinatura não encontrada.

---

[API](https://skmtc.net/cakto/apis/cakto-api.md) · [All operations](https://skmtc.net/cakto/apis/cakto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cakto/cakto-api/versions/cba77b0560b5/schema)