---
title: "Get Usage"
method: GET
path: "/usage"
tags: ["AgentQL REST API"]
---

# Get Usage

`GET /usage`

Get API key usage and subscription information for your account.

## Response `200`

Successful Response

- UsageResponse — This class represents the returned usage payload for a user.
  - `data` UsageStats, required — This class represents the exposed usage information for a user.
    - `current_subscription` SubscriptionStatus — This class represents information about the current active subscription
      - `lifetime_usage_limit` integer, nullable
      - `current_cycle_free_usage_limit` integer, nullable
      - `current_cycle_start` string, date-time, required
      - `current_cycle_end` string, date-time, required
    - `api_key_usage` UsageInfo, required — This class represents the current cycle usage & lifetime usage
      - `current_cycle` integer, nullable
      - `lifetime` integer, required
    - `total_account_usage` UsageInfo, required — This class represents the current cycle usage & lifetime usage
      - `current_cycle` integer, nullable
      - `lifetime` integer, required
  - `metadata` ResponseMetadataBase
    - `request_id` string

## Other responses

- `4XX` — Client Error

---

[API](https://skmtc.dev/agentql/apis/agentql-api.md) · [All operations](https://skmtc.dev/agentql/apis/agentql-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agentql/agentql-api/revisions/d7edf0ed4272/schema)