List Wallets

Edit online

Retrieves the list of wallets in your organization. You can filter results by the wallet owner using either a user ID or username. Pagination is supported through the limit and paginationToken query parameters.

HTTP request

GET /wallets

Authorization requirements

Header	Type	Required	Description
`Authorization`	string	Yes	Bearer token used to authenticate the request. See Authentication flows for instructions on generating this token.

Query parameter

Parameter	Type	Required	Description
`limit`	integer	No	Maximum number of items to return. Default: 50. Valid range: 1 to 500.
`paginationToken`	string	No	Opaque token used to request the next page of results. This value should come from the `nextPageToken` field of a previous response.
`owner`	string	No	Filters results by wallet owner. Accepts either an owner ID or an owner username. Minimum length: 1.

curl --request GET \
  --url 'https://api.digitalassets.ibm.com/wallets?limit=50' \
  --header 'Authorization: Bearer <token>'

Response

200: Success

The response returns the current page of results and a pagination token for retrieving subsequent pages.

Example response:

{
  "items": [
    {
      "id": "wa-1f04s-lqc9q-xxxxxxxxxxxxxxxx",
      "network": "Ethereum",
      "address": "0x00e3495cf6af59008f22ffaf32d4c92ac33dac47",
      "name": "trading hot wallet",
      "signingKey": {
        "id": "key-6ece3-9l565-xxxxxxxxxxxxxxxx",
        "scheme": "ECDSA",
        "curve": "secp256k1",
        "publicKey": "e2375c8c9e87bfcd0be8f29d76c818cabacd51584f72cb2222d49a13b036d84d3d"
      },
      "status": "Active",
      "dateCreated": "2023-04-14T20:41:28.715Z",
      "custodial": true,
      "tags": []
    }
  ],
  "nextPageToken": "<string>"
}