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
}