List Wallets

GET /wallets

cURL

curl "https://api.alguna.io/wallets?accountId=acc_abc123&active=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

const wallets = await alguna.wallets.list({
  accountId: 'acc_abc123',
  active: true
});

{
  "items": [
    {
      "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"
    },
    {
      "id": "wal_ghi789",
      "accountId": "acc_abc123",
      "name": "Promotional Credits",
      "currency": "USD",
      "currentBalance": "100.00",
      "active": true,
      "productIds": [],
      "createdAt": "2024-01-15T08:00:00Z",
      "updatedAt": "2024-01-18T14:00:00Z"
    }
  ]
}

List all wallets, optionally filtered by account or status.

accountId · string

Filter wallets by account ID.

active · boolean

Filter by active status. Returns only active wallets if true, only inactive if false.

cURL

curl "https://api.alguna.io/wallets?accountId=acc_abc123&active=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

const wallets = await alguna.wallets.list({
  accountId: 'acc_abc123',
  active: true
});

{
  "items": [
    {
      "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"
    },
    {
      "id": "wal_ghi789",
      "accountId": "acc_abc123",
      "name": "Promotional Credits",
      "currency": "USD",
      "currentBalance": "100.00",
      "active": true,
      "productIds": [],
      "createdAt": "2024-01-15T08:00:00Z",
      "updatedAt": "2024-01-18T14:00:00Z"
    }
  ]
}

items · array

Array of wallet objects.