---
title: "Allocations v5"
method: GET
path: "/v5/allocations/{tokenId}"
tags: ["Allocations"]
---

# Allocations v5

`GET /v5/allocations/{tokenId}`

Get all token allocations. v5 moves the token identifier from a query param to a path param.

## Path parameters

- `tokenId` string, required

## Response `200`

Successful response

- object
  - `metadata` Metadata
    - `queryDate` string, date-time — Timestamp of the query
    - `credit` Credit — Optional quota state for the calling account, returned on most authenticated responses (both success and error). Treat it as optional: it may be absent on unauthenticated requests, demo/playground responses, and briefly right after a monthly reset. `used` is near-real-time and may lag the true count by a request or two.
      - `used` integer — Requests counted in the current window (approximate / eventually consistent).
      - `limit` integer — The plan's request quota for the window.
      - `resetAt` string, date-time — When the quota resets (RFC3339 UTC). Present for monthly plans; absent for lifetime-quota plans.
  - `status` boolean
  - `data` object
    - `name` string
    - `symbol` string
    - `listedMethod` 'INTERNAL' | 'AI' | 'EXTERNAL'
    - `maxSupply` number, nullable
    - `lastUpdatedDate` string, date-time
    - `totalUnlockedAmount` number
    - `totalLockedAmount` number
    - `totalUntrackedAmount` number
    - `totalTBDLockedAmount` number
    - `allocations` Allocation[]
      - `allocationName` string — Allocation name
      - `allocationType` 'Scheduled' | 'TBD' | 'Untracked' — Type of allocation
      - `standardAllocationName` string — Standard allocation of this allocation
      - `allocationUnlockedAmount` number — Current unlocked amount of the allocation
      - `allocationLockedAmount` number — Current locked amount of the allocation
      - `allocationAmount` number — Total token amount assign to this allocation
      - `trackedAllocationPercentage` number — Total track allocation percentage not include untrack

---

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