Get Subscription

GET/api/v1/bank/wallet/subscription/Bearer TokenRetrieve subscription details and charge history

Authentication

Include your API key in the Authorization header. See Authentication for details.

Query parameters

Parameter	Type	Required	Description
wallet_uuid	UUID	Yes	Wallet identifier
subscription_uuid	UUID	Yes	Subscription identifier

Example URL:

https://core-manager.a55.tech/api/v1/bank/wallet/subscription/?wallet_uuid=abc-123&subscription_uuid=def-456

Response

200 Success

{
  "subscription_uuid": "def-456",
  "cycle": "monthly",
  "end_date": "2026-12-31",
  "status": "active",
  "description": "Premium plan",
  "next_due_date": "2026-04-15",
  "charges": [
    {
      "charge_uuid": "chg-001",
      "amount": "49.90",
      "status": "confirmed",
      "created_at": "2026-03-15T10:00:00Z"
    }
  ]
}

404 Not Found

{ "error": "Subscription not found" }

404 Wallet Not Found

{ "error": "Wallet not found" }

Subscription states

Status	Description	Transitions to
pending	Created, awaiting first charge	active, error, cancelled
active	Billing on schedule	cancelled, expired, error
error	Charge failed after retries	active, cancelled
cancelled	Merchant or customer cancelled	Terminal
expired	Reached end_date	Terminal

Code examples

cURL

curl -X GET "https://core-manager.a55.tech/api/v1/bank/wallet/subscription/?wallet_uuid=abc-123&subscription_uuid=def-456" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import requests

resp = requests.get(
    "https://core-manager.a55.tech/api/v1/bank/wallet/subscription/",
    params={"wallet_uuid": "abc-123", "subscription_uuid": "def-456"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
data = resp.json()
print(f"Status: {data['status']} | Next due: {data['next_due_date']}")

JavaScript

const resp = await fetch(
  "https://core-manager.a55.tech/api/v1/bank/wallet/subscription/?wallet_uuid=abc-123&subscription_uuid=def-456",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
const data = await resp.json();
console.log(`Status: ${data.status} | Next due: ${data.next_due_date}`);

Postman: Import the A55 API Collection to test this endpoint interactively.