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

# Get Stake Info

> Read details of a specific stake position

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

Returns the principal, start time, lock duration, reward percent, and active flag for a specific stake. Indexes are 0-based and correspond to creation order; use [`/stake-count`](/api-reference/tokens/staking/stake-count) to find the highest valid index.

If the index doesn't exist for this customer, the endpoint returns zeros and `active: false` rather than an error.

### Query Parameters

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

<ParamField query="stake_index" type="integer" required>
  0-based index of the stake position
</ParamField>

### Response

<ResponseField name="amount" type="string">
  Principal locked in the stake
</ResponseField>

<ResponseField name="start_time" type="string">
  Unix timestamp (seconds) when the stake was created
</ResponseField>

<ResponseField name="lock_duration" type="string">
  Configured lock period in seconds
</ResponseField>

<ResponseField name="reward_percent" type="number">
  Reward percent earned at full lock period
</ResponseField>

<ResponseField name="active" type="boolean">
  `true` if the stake is still locked; `false` once unstaked
</ResponseField>

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

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "amount": "100.0",
    "start_time": "1715000000",
    "lock_duration": "2592000",
    "reward_percent": 5,
    "active": true
  }
  ```
</ResponseExample>