---
title: "Get vesting balances for multiple allocations"
method: POST
path: "/vesting/balances"
tags: ["Vesting"]
---

# Get vesting balances for multiple allocations

`POST /vesting/balances`

Get vesting balances for multiple allocation IDs in a single request. Returns per-allocation results with balance breakdowns including available, unvested, and locked amounts. Individual allocation errors are returned inline rather than failing the entire batch.

## Request body

- GetVestingBalancesBatchRequest
  - `allocationIds` string[], required — List of allocation IDs to get vesting balances for
  - `stakeholderId` string — The external stakeholder ID (optional, used to retrieve wallet info when no transactions exist yet)

## Response `200`

Batch vesting balances for the requested allocations

- VestingBalancesBatchResponse
  - `errorCount` integer, required — Number of allocations that failed
  - `results` VestingBalancesResult[], required — Per-allocation vesting balance results
    - `allocationId` string, required — The allocation ID this result corresponds to
    - `balance` VestingBalance
      - `assetType` string, required — A string representing a type of crypto-asset, which usually corresponds to the crypto asset's ticker symbol.
      - `availableBalance` string, required — Amount of tokens unlocked for this allocation
      - `externalTokenId` string, required — The ID of the asset assigned by the external provider that funds these wallets
      - `lockedBalance` string, required — Amount of tokens on hold to be released to this stakeholder for this allocation
      - `networkId` string, required — The network identifier for the blockchain network
      - `unvestedBalance` string, required — Amount of tokens still scheduled to be released to this stakeholder for this allocation
    - `error` string, nullable — Error message if this allocation failed, null on success
    - `walletInfo` WalletInfo
      - `address` string, required — The public address of the wallet associated with this allocation
      - `walletId` string, required — The ID of the wallet associated with this allocation
  - `successCount` integer, required — Number of allocations successfully processed

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/anchorage/apis/anchorage-digital-api-reference.md) · [All operations](https://skmtc.net/anchorage/apis/anchorage-digital-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anchorage/anchorage-digital-api-reference/versions/166864b1ec6d/schema)