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

# GET /analytics/summary — Current Month Spend Summary

> Returns the current-month total spend in USD, budget utilization percentage, and a per-model cost breakdown for your Tokonomics account.

The summary endpoint gives you a real-time snapshot of your AI spend for the current calendar month. You get the total spend in USD, how much of your configured monthly budget you've consumed, and a per-model breakdown so you can see exactly which models are driving your costs.

**Endpoint**

```text theme={null}
GET https://tokonomics.ca/analytics/summary
```

## Authentication

This endpoint requires a valid Bearer token in the `Authorization` header.

```text theme={null}
Authorization: Bearer mk_your_key
```

## Response Fields

<ResponseField name="current_month_spend" type="number">
  Your total AI spend for the current calendar month in USD. Example: `127.45`
</ResponseField>

<ResponseField name="monthly_budget" type="number">
  The monthly budget cap configured for your account in USD. Requests are blocked with a `429` once this limit is reached. Example: `500.00`
</ResponseField>

<ResponseField name="budget_used_percent" type="number">
  The percentage of your monthly budget already consumed. Calculated as `(current_month_spend / monthly_budget) * 100`. Example: `25.49`
</ResponseField>

<ResponseField name="by_model" type="array">
  A breakdown of spend and request count per model for the current month.

  <Expandable title="by_model fields">
    <ResponseField name="model" type="string">
      The model name. Example: `"gpt-4o"`
    </ResponseField>

    <ResponseField name="spend" type="number">
      Total spend for this model in USD for the current month. Example: `89.20`
    </ResponseField>

    <ResponseField name="requests" type="integer">
      Total number of requests made to this model in the current month. Example: `4520`
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

<CodeGroup>
  ```bash Request theme={null}
  curl "https://tokonomics.ca/analytics/summary" \
    -H "Authorization: Bearer mk_your_key"
  ```

  ```json Response theme={null}
  {
    "current_month_spend": 127.45,
    "monthly_budget": 500.00,
    "budget_used_percent": 25.49,
    "by_model": [
      {"model": "gpt-4o", "spend": 89.20, "requests": 4520},
      {"model": "claude-opus-4-5", "spend": 38.25, "requests": 1100}
    ]
  }
  ```
</CodeGroup>