Consultar Assinatura

GET/api/v1/bank/wallet/subscription/Bearer Token

Autenticação

Requer Bearer token. Veja Autenticação.

Parâmetros da requisição

Parâmetros de query:

Campo	Tipo	Obrigatório	Descrição
wallet_uuid	string (UUID)	Sim	Carteira proprietária da assinatura
subscription_uuid	string (UUID)	Sim	Assinatura a ser consultada

URL de exemplo

GET /api/v1/bank/wallet/subscription/?wallet_uuid=890023ec-aeaf-4be2-9d86-a244ba0f4ac&subscription_uuid=96b95c56-34f0-48c0-93e9-ac5fc6d3f3d5

Exemplos de resposta

200 Sucesso

{
  "subscription_uuid": "96b95c56-34f0-48c0-93e9-ac5fc6d3f3d5",
  "cycle": "monthly",
  "end_date": "2027-06-30",
  "status": "active",
  "description": "Premium Plan",
  "next_due_date": "2026-04-30",
  "charges": [
    {
      "charge_uuid": "c950b2e5-95f8-40c2-b58e-e3c66c6cc100",
      "value": 99.90,
      "currency": "BRL",
      "date": "2026-03-30",
      "status": "confirmed"
    }
  ]
}

404 Não Encontrado

{
  "code": "errors.subscription.not_found"
}

404 Carteira Não Encontrada

{
  "code": "errors.wallet.not_found"
}

Estados da assinatura

Status	Descrição	Transiciona para
pending	Cobrança inicial ainda não confirmada	active, error
active	Ativa — cobranças geradas por ciclo	error, cancelled, expired
error	Última tentativa de cobrança falhou	active (retentativa), cancelled, expired
cancelled	Interrompida manualmente	Terminal
expired	Data final atingida ou retentativas esgotadas	Terminal

Exemplos de código

cURL

curl -sS 'https://core-manager.a55.tech/api/v1/bank/wallet/subscription/?wallet_uuid=890023ec-aeaf-4be2-9d86-a244ba0f4ac&subscription_uuid=96b95c56-34f0-48c0-93e9-ac5fc6d3f3d5' \
  -H 'Authorization: Bearer $ACCESS_TOKEN'

Python

import os, requests

r = requests.get(
    "https://core-manager.a55.tech/api/v1/bank/wallet/subscription/",
    headers={"Authorization": f"Bearer {os.environ['ACCESS_TOKEN']}"},
    params={
        "wallet_uuid": "890023ec-aeaf-4be2-9d86-a244ba0f4ac",
        "subscription_uuid": "96b95c56-34f0-48c0-93e9-ac5fc6d3f3d5",
    },
    timeout=30,
)
sub = r.json()
print(f"Status: {sub['status']}, next billing: {sub['next_due_date']}")

JavaScript

const params = new URLSearchParams({
  wallet_uuid: '890023ec-aeaf-4be2-9d86-a244ba0f4ac',
  subscription_uuid: '96b95c56-34f0-48c0-93e9-ac5fc6d3f3d5',
});
const res = await fetch(
  `https://core-manager.a55.tech/api/v1/bank/wallet/subscription/?${params}`,
  { headers: { Authorization: `Bearer ${process.env.ACCESS_TOKEN}` } }
);
const sub = await res.json();