---
title: "My Allocations"
method: GET
path: "/api/{portalId}/user/allocations"
tags: ["Token"]
---

# My Allocations

`GET /api/{portalId}/user/allocations`

## Request

- Base URL: `https://portal-api.magna.so`
- URL: `https://portal-api.magna.so/api/{portalId}/user/allocations`
- Auth: none declared

Returns a list of allocations based on the session

## Path parameters

- `portalId` string, uuid, required

## Headers

- `cursor` number: cursor for pagination; not required for the first page; for subsequent pages, use the cursor from the previous response (x-cursor response header)

## Response `200`

Ok

- object[]: Ok
  - `id` string, uuid, required: unique allocation id
  - `claimed` string, required: number of tokens claimed (received by the stakeholder)
  - `vested` string, required: number of tokens vested (available to the stakeholder)
  - `total` string, required: total number of tokens allocated to the stakeholder
  - `category` string, required: category of the allocation
  - `timestamps` object[], required: unlock timestamps for the allocation
    - `timestamp` number, required: timestamp of the unlock
    - `amount` string, required: amount of tokens unlocked at the timestamp
  - `createdAt` string, required: allocation creation timestamp
  - `description` string, nullable, required: description of the allocation
  - `isOffChainClaim` boolean, required: whether the allocation is off-chain
  - `isWalletSubmitted` boolean, nullable, required: is wallet submitted for allocation
  - `submittedWallet` string, nullable, required: submitted wallet for allocation

## Other responses

- `400`: Client Error
- `500`: Server Error
- `502`: Upstream Error — the portal configuration service could not be reached. Safe to retry.

---

[API](https://skmtc.dev/magna/apis/magna-portal-api.md) - [All operations](https://skmtc.dev/magna/apis/magna-portal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/magna/apis/magna-portal-api/revisions/50f736d73198?raw)