API Usage

Get Api Usage Endpoint

get

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

Query parameters

api_keyany ofOptional

API key for authentication (query)

stringOptional

or

nullOptional

Header parameters

x-api-keyany ofOptional

API key for authentication (header)

stringOptional

or

nullOptional

Responses

200

Successful response

application/json

plan_namestringRequired

current_usage_period_startstring · date-timeRequired

current_usage_period_endstring · date-timeRequired

422

Validation Error

application/json

get

/api_usage

HTTPcURLJavaScriptPython

GET /v1/api_usage HTTP/1.1
Host: api.gridstatus.io
Accept: */*

{
  "plan_name": "Example Plan",
  "limits": {
    "api_rows_returned_limit": 25000000,
    "api_requests_limit": 100000,
    "api_rows_per_response_limit": 90000,
    "per_second_api_rate_limit": 3,
    "per_minute_api_rate_limit": 20,
    "per_hour_api_rate_limit": 900
  },
  "current_usage_period_start": "2025-10-01T00:00:00Z",
  "current_usage_period_end": "2025-10-30T00:00:00Z",
  "current_period_usage": {
    "total_requests": 30000,
    "total_api_rows_returned": 1500000
  }
}