Skip to main content
GET
/
public_api
/
subscriptions
/
{id}
/
billing-cycles
/
{cycle_id}
/
cURL
curl --request GET \
  --url https://api.cakto.com.br/public_api/subscriptions/{id}/billing-cycles/{cycle_id}/ \
  --header 'Authorization: Bearer <token>'
{
  "id": "f15d1962-bba0-4e66-a147-f59a48935f29",
  "cycle_number": 1,
  "due_date": "2026-05-18T19:14:17.677041Z",
  "amount": "100.00",
  "status": "paid",
  "total_attempts": 2,
  "completed_at": "2026-05-18T19:15:02.123456Z",
  "created_at": "2026-05-18T19:14:17.677041Z",
  "attempts": [
    {
      "id": "d9abeb29-6c7d-46fa-938a-4fbce40be05d",
      "attempt_number": 1,
      "amount": "100.00",
      "result": "failure",
      "failure_reason": "Insufficient funds",
      "scheduled_for": "2026-05-18T19:14:17.677041Z",
      "started_at": "2026-05-18T19:14:18.123456Z",
      "completed_at": "2026-05-18T19:14:20.789012Z",
      "created_at": "2026-05-18T19:14:17.677041Z"
    },
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "attempt_number": 2,
      "amount": "100.00",
      "result": "success",
      "failure_reason": null,
      "scheduled_for": "2026-05-19T19:14:17.677041Z",
      "started_at": "2026-05-19T19:14:18.000000Z",
      "completed_at": "2026-05-19T19:14:22.000000Z",
      "created_at": "2026-05-18T19:14:17.677041Z"
    }
  ]
}

​
Escopo

    read subscriptions

​
Quando usar

  • Para investigar uma cobrança específica que o cliente questionou
  • Para analisar o histórico de tentativas de um ciclo pendente
  • Para confirmar se um pagamento foi processado corretamente

​
O que a resposta inclui

A resposta traz o ciclo completo com o array attempts aninhado. Cada tentativa mostra:
CampoDescrição
attempt_numberNúmero da tentativa (1ª, 2ª, 3ª…)
resultsuccess ou failure
failure_reasonMotivo da falha, quando houver
scheduled_forData agendada para a tentativa
started_atQuando a tentativa iniciou
completed_atQuando a tentativa finalizou
Compare scheduled_for com completed_at para identificar atrasos no processamento da cobrança.
O cycle_id deve ser o identificador retornado pelo endpoint de listagem de ciclos.

Authorizations

​
Authorization
string
header
required

Token de autenticação do tipo Bearer {access_token}, onde {access_token} é o token obtido no fluxo de autenticação.

Path Parameters

​
id
string<uuid>
required

ID da assinatura

​
cycle_id
string<uuid>
required

ID do ciclo de cobrança

Response

Corpo da resposta status 200

​
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

​
created_at
string<date-time>
required

Data de criação

​
attempts
object[]
required

Lista de tentativas de cobrança

​
completed_at
string<date-time>

Data de conclusão