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

# Retrieve usage

> Usage statistics for the current API key

<ResponseField name="total_requests" type="integer" required>
  Lifetime request count for this key.
</ResponseField>

<ResponseField name="last_request_at" type="string">
  ISO 8601 timestamp of the most recent request, or `null`.
</ResponseField>

<ResponseField name="by_endpoint" type="object[]">
  Breakdown by path.
</ResponseField>

<ResponseField name="by_status" type="object[]">
  Breakdown by HTTP status.
</ResponseField>

## SDK

<CodeGroup>
  ```typescript TypeScript theme={null}
  const usage = await client.usage.retrieve();
  ```

  ```python Python theme={null}
  usage = await client.usage.retrieve()
  ```
</CodeGroup>