API · Assinaturas

Listar ciclos

GET /api/crypto/v1/subscriptions/{id}/orders — histórico de cobranças.

GET /api/crypto/v1/subscriptions/{id}/orders

Autentique com X-Manage-Token, usando o token retornado na criação. O backend também aceita manageToken na query, mas prefira o cabeçalho para evitar exposição em histórico e logs.

curl 'https://api.caedral.com/api/crypto/v1/subscriptions/ID_DA_ASSINATURA/orders' \
  -H 'X-Manage-Token: SEU_MANAGE_TOKEN'

200 retorna { "orders": [...], "count": 0 }. Cada item contém os campos disponíveis de ref, status, amountBRL, cryptoAmount, feeAmount, token, paidAt e createdAt. A lista é ordenada da mais recente para a mais antiga e limitada a 200 ordens; não há paginação nesta rota. count é a quantidade retornada, não necessariamente o total histórico.

404: assinatura não encontrada ou token inválido; 500: erro interno. Consulte uma ordem individual para obter mais detalhes.

Exemplo de resposta 200

Os valores são ilustrativos e variam conforme o ambiente e a ordem.

{
  "orders": [
    {
      "ref": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "status": "pending",
      "amountBRL": 49.9,
      "cryptoAmount": "9.330000",
      "feeAmount": "0.100000",
      "token": "USDC",
      "paidAt": null,
      "createdAt": "2026-11-08T18:00:00.000Z"
    }
  ],
  "count": 1
}