Skip to content
throttle
Menu
HomeAPI LimitsCloudflare API

Infrastructure

Cloudflare API

APIs for Cloudflare accounts, zones, DNS, security, Workers, analytics, and other infrastructure services.

PUBLISHED PROVIDER LIMITS

Limits keep their provider-specific dimensions.

The Client API applies cumulative limits across Cloudflare API calls, while GraphQL and individual products can add separate controls.

Authentication: API token, Global API key

Primary scope: User, Account Token, Or Source IP

Measured dimensions: Requests, Graphql Queries, Active API Tokens

Profile coverage: Cloudflare Client API user, token, and source-IP limits, GraphQL request limits, API-token quotas, response headers, and exceeded-limit behavior. Product-specific API limits remain outside this profile.

Global limits

Cloudflare API Global limits
LimitValuePeriodScopeConditions and variability
Client API per user or account token1,200 requestsPer 5 minuteUser Or Account TokenCumulative across Cloudflare API calls
Client API per source IP200 requestsPer secondSource IpPublished provider limit.

Graphql Rate

Cloudflare API Graphql Rate
LimitValuePeriodScopeConditions and variability
GraphQL API maximum320 queriesPer 5 minuteUser Or Account TokenGraphQL queries are also constrained by query cost.

Resource Limit

Cloudflare API Resource Limit
LimitValuePeriodScopeConditions and variability
User API token quota50 active tokensAt one timeUserPublished provider limit.
Account API token quota500 active tokensAt one timeAccountPublished provider limit.

RESPONSE METADATA

Headers expose the applicable limit state.

RateLimitFormat: Structured Field
Current quota, remaining capacity, and reset delay for the applicable Cloudflare policy.
RateLimit-PolicyFormat: Structured Field
Cloudflare rate-limit policy details, including the quota and time window.
Retry-AfterFormat: Integer Seconds
Seconds, rounded up, until Cloudflare allows another request.

WHEN A LIMIT IS EXCEEDED

Read the response before choosing a delay.

  • Rate-limit responses can use HTTP 429.
  • Exceeding the Client API limit temporarily blocks Cloudflare API calls for the applicable identity.

RECOMMENDED HANDLING

Protect both the provider and your own queue.

  • Read RateLimit and RateLimit-Policy on successful responses.
  • Honor Retry-After after a 429 response.
  • Account for GraphQL query cost and product-specific limits separately.

VERIFICATION RECORD

Official sources reviewed