List Allocations

Edit online

Retrieves a paginated list of all allocations in the organization.

HTTP request
GET/allocations
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 Default Description
limit integer 50 Maximum number of items to return. Must be between 1 and 500.
paginationToken string None Opaque token used to retrieve the next page of results. Returned as nextPageToken in the previous response. Minimum length is 1.
Request body
curl --request GET \
  --url 'https://api.digitalassets.ibm.com/allocations?limit=50' \
  --header 'Authorization: Bearer <token>'
Response
200: Success

Example response:

{
  "items": [
    {
      "id": "allctn-6a3ku-bn8d7-8u5rs1oukojms7k8",
      "walletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
      "protocol": "0fns",
      "amount": {
        "kind": "Erc20",
        "contract": "0x0A7660979A67E4bC51E750C628C8479ff9F458aE",
        "amount": "1000000000",
        "metadata": {
          "network": "EthereumSepolia",
          "name": "0fns",
          "symbol": "0fnsSepolia",
          "decimals": 6,
          "tid": "erc20:0x0A7660979A67E4bC51E750C628C8479ff9F458aE"
        }
      },
      "rewards": {
        "kind": "Erc20",
        "contract": "0x0A7660979A67E4bC51E750C628C8479ff9F458aE",
        "amount": "5000000",
        "metadata": {
          "network": "EthereumSepolia",
          "name": "0fns",
          "symbol": "0fnsSepolia",
          "decimals": 6,
          "tid": "erc20:0x0A7660979A67E4bC51E750C628C9479ff9F458aE"
        }
      },
      "dateCreated": "2025-10-09T10:57:55.758Z"
    }
  ],
  "nextPageToken": "<string>"
}