Grid Status · Rate Limits

Gridstatus Rate Limits

The hosted Grid Status API is metered primarily on rows returned per month rather than on raw request counts alone. The live API's usage model (surfaced by the GET /api_usage endpoint) defines six per-plan limits - total rows returned, total requests, rows per response, and per-second, per-minute, and per-hour request rate limits. The free plan is documented at 500,000 rows returned per month in the gridstatusio client README; paid plans raise the allowances. Numeric per-plan rate limit values are not published on a public docs page and are visible to each account via /api_usage, so they are not reconciled here.

Gridstatus Rate Limits is the machine-readable rate-limit profile for Grid Status on the APIs.io network, conforming to the API Commons Rate Limits specification.

It captures 7 rate-limit definitions, measuring rows and requests.

The profile also includes 4 backoff/retry policies defined and response codes documented for throttled.

Tagged areas include Day-Ahead Prices, Electricity, Grid Data, Energy Markets, and Rate Limiting.

7 Limits Throttle: 429
Day-Ahead PricesElectricityGrid DataEnergy MarketsRate LimitingQuotas

Limits

Rows Returned per Month (Free) account
rows
500000
Free plan allowance documented in the gridstatusio client README; the primary metered unit.
Rows Returned per Month (Paid) account
rows
per plan
Reported per account as api_rows_returned_limit by GET /api_usage.
API Requests account
requests
per plan
Reported per account as api_requests_limit by GET /api_usage.
Rows per Response request
rows
per plan
Maximum rows in a single response (api_rows_per_response_limit); page through larger results with page_size and cursor.
Requests per Second account
requests
per plan
Reported as per_second_api_rate_limit by GET /api_usage.
Requests per Minute account
requests
per plan
Reported as per_minute_api_rate_limit by GET /api_usage.
Requests per Hour account
requests
per plan
Reported as per_hour_api_rate_limit by GET /api_usage.

Policies

Row-Based Metering
Usage is metered on rows returned, so always pass a limit parameter and select only needed columns to conserve your monthly allowance.
Backoff Strategy
The official gridstatusio client retries rate-limited requests with configurable exponential backoff; custom clients should do the same and honor 429 responses.
Bulk Export Path
For large historical pulls, use the per-day bulk CSV export files (presigned S3 URLs) instead of paging the query endpoint.
Usage Visibility
GET /api_usage returns your plan name, all six limits, and current billing period consumption for programmatic budget checks.

Sources