Get Wallet

GET

wallets

{id}

curl https://api.alguna.io/wallets/wal_def456 \
  -H "Authorization: Bearer YOUR_API_KEY"

const wallet = await alguna.wallets.get('wal_def456');

{
  "id": "wal_def456",
  "accountId": "acc_abc123",
  "name": "Prepaid Credits",
  "currency": "USD",
  "currentBalance": "500.00",
  "active": true,
  "productIds": ["prod_xyz789"],
  "createdAt": "2024-01-20T10:00:00Z",
  "updatedAt": "2024-01-20T12:00:00Z"
}

Retrieve a wallet by its ID.

string

required

The wallet ID.

curl https://api.alguna.io/wallets/wal_def456 \
  -H "Authorization: Bearer YOUR_API_KEY"

const wallet = await alguna.wallets.get('wal_def456');

{
  "id": "wal_def456",
  "accountId": "acc_abc123",
  "name": "Prepaid Credits",
  "currency": "USD",
  "currentBalance": "500.00",
  "active": true,
  "productIds": ["prod_xyz789"],
  "createdAt": "2024-01-20T10:00:00Z",
  "updatedAt": "2024-01-20T12:00:00Z"
}

string

Unique identifier for the wallet.

string

The account this wallet belongs to.

string

Display name of the wallet.

string

Currency code for the wallet balance.

string

Current balance as a decimal string.

boolean

Whether the wallet is active and can be used.

array

Product IDs the wallet is restricted to, if any.

string

ISO 8601 timestamp of creation.

string

ISO 8601 timestamp of last update.

List Wallets

⌘I

curl https://api.alguna.io/wallets/wal_def456 \
  -H "Authorization: Bearer YOUR_API_KEY"

const wallet = await alguna.wallets.get('wal_def456');

{
  "id": "wal_def456",
  "accountId": "acc_abc123",
  "name": "Prepaid Credits",
  "currency": "USD",
  "currentBalance": "500.00",
  "active": true,
  "productIds": ["prod_xyz789"],
  "createdAt": "2024-01-20T10:00:00Z",
  "updatedAt": "2024-01-20T12:00:00Z"
}

API Reference

Billing Events & Usage Metering

Bundles

Credit Grants

Credit Notes

Customers

Invoices

Plans

Products

Refunds

Subscriptions

Subscription Versions

Wallets