---
title: "Get Api Usage Endpoint"
method: GET
path: "/api_usage"
tags: ["API Usage"]
---

# Get Api Usage Endpoint

`GET /api_usage`

Get API usage statistics and limits for the current user/organization.

## Query parameters

- `api_key` string, nullable — API key for authentication (query)

## Headers

- `x-api-key` string, nullable — API key for authentication (header)

## Response `200`

Successful response

- APIUsageResponse
  - `plan_name` string, required
  - `limits` APIUsageLimits, required
    - `api_rows_returned_limit` integer, required
    - `api_requests_limit` integer, required
    - `api_rows_per_response_limit` integer, required
    - `per_second_api_rate_limit` integer, required
    - `per_minute_api_rate_limit` integer, required
    - `per_hour_api_rate_limit` integer, required
  - `current_usage_period_start` string, date-time, required
  - `current_usage_period_end` string, date-time, required
  - `current_period_usage` CurrentPeriodUsage, required
    - `total_requests` integer, required
    - `total_api_rows_returned` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/gridstatus/apis/grid-status-api.md) · [All operations](https://skmtc.net/gridstatus/apis/grid-status-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gridstatus/grid-status-api/versions/fa1f094be2d4/schema)