---
title: "Claim Allocations"
method: GET
path: "/api/v2/{portalId}/claim/allocations"
tags: ["Claim"]
---

# Claim Allocations

`GET /api/v2/{portalId}/claim/allocations`

## Request

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

Retrieves the list of allocations for the user claim wallet

## Path parameters

- `portalId` string, uuid, required

## Response `200`

200

- object
  - `allocations` object[], required
    - `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
  - `pohPassed` boolean, nullable, required: whether the proof of humanity check was passed

## 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)