List wallets

Return your wallets, newest first, with optional filters and cursor pagination.

GET/v1/wallets
wallet

Returns your wallets newest-first, with cursor pagination and optional filters.

Try it, for realGET /walletsscope: wallet

Test keys only. Never paste a live key. Your key is stored only in this browser (localStorage) and sent only to the same-origin playground proxy.

›Equivalent request (curl / TypeScript)
curl
curl -X GET https://sandbox.api.acute.network/v1/wallets \
  -H "Authorization: Bearer acuinf_test_…"
TypeScript
const res = await fetch("https://sandbox.api.acute.network/v1/wallets", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.ACUTE_TEST_KEY}`,
  },
});
const { data, meta } = await res.json();

# list active, tier1 wallets
curl "https://sandbox.api.acute.network/v1/wallets?status=active&kycStatus=tier1&limit=20" \
  -H "Authorization: Bearer acuinf_test_…"
{
  "success": true,
  "statusCode": 200,
  "data": [
    {
      "id": "acuinf483920175566wlt",
      "kind": "end_user",
      "email": "ada@example.com",
      "fullName": "Ada Lovelace",
      "phone": null,
      "externalReference": "cust_8842",
      "kycStatus": "tier1",
      "status": "active",
      "currency": "NGN",
      "createdAt": "2026-06-24T09:14:02.118Z"
    }
  ],
  "pagination": { "limit": 20, "hasMore": false, "nextCursor": null },
  "meta": { "requestId": "req_4f9c2a7e1b0d8c3a5e6f10a2" }
}

status'active' | 'frozen' | 'closed'queryoptional

Filter by wallet status.

kycStatus'none' | 'tier1'queryoptional

Filter by KYC tier.

qstringqueryoptional

Free-text search over email / name / external reference.

limitintegerqueryoptionaldefault: 20

Page size, clamped to [1, 100].

cursorstringqueryoptional

The previous page's nextCursor.

A paginated list of WalletResponseData (see create for the per-wallet shape). The list response adds a pagination block; see the envelope.

pagination.limitintegerrequired

The resolved page size actually applied.

pagination.hasMorebooleanrequired

true if another page exists. Stop when it's false.

pagination.nextCursorstring | nullrequired

The token for the next page, or null on the last page.