Get wallets | Mitu API Documentation

{
  "message": "Wallets retrieved successfully",
  "data": [
    {
      "id": "wal_65286515b43d4e3eba93",
      "customer_id": "cus_0t9549fps3xd",
      "name": "Travel",
      "currency": "USDC",
      "status": "active",
      "frozen_at": null,
      "frozen_reason": null,
      "balance": {
        "total": "0.067000",
        "by_chain": {
          "base": "0.067000",
          "solana": "0",
          "tempo": "0"
        }
      },
      "limits": {
        "per_payment": 25,
        "session": 50,
        "daily": 100,
        "monthly": 200,
        "approve_above": 50,
        "currency": "USD"
      },
      "created_at": "2026-09-11T00:32:58.292Z"
    }
  ],
  "meta": {
    "total": 84,
    "limit": 20,
    "has_more": true,
    "next_cursor": "cur_01HXYZ9999XXXXXX"
  }
}

List a customer's Agent Wallets.

Authentication

x-api-keystring

Account API key used to authenticate server-side requests. Use the credentials issued for the same environment as the API base URL.

Path parameters

idstringRequired

Unique identifier of the resource.

Query parameters

statusenumOptional

Only wallets in this state.

Allowed values:

limitintegerOptional1-100Defaults to 20

Maximum number of records to return.

cursorstringOptional

Cursor returned as next_cursor from the previous response. Omit for the first request.

Response

Wallets retrieved successfully.

messagestring

datalist of objects

metaobjectOptional

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error