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

# User Info

> Full snapshot of a customer's token state in a single call

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

Returns balance, lifetime earnings/spending, total staked, total vested, current tier, and voting power in one response. Useful for rendering a customer dashboard without making multiple calls.

### Query Parameters

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

### Response

<ResponseField name="available_balance" type="string">
  Spendable balance (excludes staked and unvested tokens)
</ResponseField>

<ResponseField name="each_token_value" type="string">
  Configured value of one token in your chosen currency
</ResponseField>

<ResponseField name="each_token_value_in_business" type="string">
  Discounted token value when spent at your business
</ResponseField>

<ResponseField name="total_staked" type="string">
  Tokens locked across all active stakes
</ResponseField>

<ResponseField name="total_vested" type="string">
  Tokens currently held in an unclaimed vesting grant
</ResponseField>

<ResponseField name="total_earned" type="string">
  Lifetime tokens earned (all sources)
</ResponseField>

<ResponseField name="total_spent" type="string">
  Lifetime tokens redeemed
</ResponseField>

<ResponseField name="tier" type="string">
  Current tier label, one of `"None"`, `"Bronze"`, `"Silver"`, `"Gold"`
</ResponseField>

<ResponseField name="voting_power" type="string">
  Number of votes this customer has based on their available balance
</ResponseField>

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

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "available_balance": "50.0",
    "each_token_value": "10.0",
    "each_token_value_in_business": "9.0",
    "total_staked": "100.0",
    "total_vested": "0.0",
    "total_earned": "200.0",
    "total_spent": "50.0",
    "tier": "Bronze",
    "voting_power": "5"
  }
  ```
</ResponseExample>