---
title: "Get Allocations information by asset IDs"
method: GET
path: "/token-unlocks/v1/allocations"
tags: ["token-unlocks/Allocations"]
---

# Get Allocations information by asset IDs

`GET /token-unlocks/v1/allocations`

Returns allocation information given a set of asset IDs and optional filters

## Query parameters

- `assetId` string, required

## Response `200`

Default response

- object
  - `data` AllocationAggregate[], required
    - `allocationRecipientCount` integer, required
    - `allocations` AllocationTranche[], required
    - `asset` AssetBasic, required — Schema for AssetBasic
    - `cumulativeUnlockedNative` number, double, required
    - `cumulativeUnlockedUSD` number, double
    - `genesisDate` string, date-time
    - `lastUpdatedAt` string, date-time
    - `percentOfUnlocksCompleted` number, double, required
    - `projectedEndDate` string, date-time
    - `totalAllocationNative` number, double, required
    - `totalAllocationUSD` number, double
    - `unlocksRemainingNative` number, double, required
    - `unlocksRemainingUSD` number, double
  - `error` string

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.net/messari/apis/messari-api-deep-research-v1.md) · [All operations](https://skmtc.net/messari/apis/messari-api-deep-research-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/messari/messari-api-deep-research-v1/revisions/af35b9757e14/schema)