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

# Event Allocation

> Total tokens awarded for an event across all customers

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

Returns how many tokens you've distributed for a given event since launch. Useful for usage analytics.

### Query Parameters

<ParamField query="event_name" type="string" required>
  The event identifier
</ParamField>

### Response

<ResponseField name="total_allocation" type="string">
  Sum of tokens awarded for this event across every customer
</ResponseField>

```javascript theme={null}
const res = await fetch(
  "https://tokens.shakesco.com/event-allocation?event_name=purchase",
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);
const { total_allocation } = await res.json();
```

<ResponseExample>
  ```json 200 OK theme={null}
  { "total_allocation": "15.0" }
  ```
</ResponseExample>