> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shakesco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vested Amount

> Read the amount currently claimable from a customer's vesting grant

<span style={{display:"none"}}>For the complete documentation index, see [llms.txt](/llms.txt).</span>

Returns how many tokens are vested but not yet claimed for this customer. This is the amount [`/claim-vested-tokens`](/api-reference/tokens/vesting/claim-vested-tokens) would move into available balance if called right now. Returns `"0"` if there's no active grant or nothing has vested yet.

### Query Parameters

<ParamField query="customer_ref" type="string" required>
  Your unique identifier for this customer
</ParamField>

### Response

<ResponseField name="vested_amount" type="string">
  Tokens currently claimable
</ResponseField>

```javascript theme={null}
const res = await fetch(
  "https://tokens.shakesco.com/vested-amount?customer_ref=customer-123",
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);
const { vested_amount } = await res.json();
```

<ResponseExample>
  ```json 200 OK theme={null}
  { "vested_amount": "125.0" }
  ```
</ResponseExample>