Organization rate limits API

The organization rate limits API endpoint allows you to obtain a Buildkite organization's current REST API and GraphQL API rate limit status.

Get rate limits

Returns the current REST API and GraphQL API rate limits for a Buildkite organization.

curl -H "Authorization: Bearer $TOKEN" \
  https://api.buildkite.com/v2/organizations/{organization.slug}/rate_limit

{
  "scopes": {
    "rest": {
      "limit": 200,
      "current": 5,
      "reset": 35,
      "reset_at": "2025-12-02T05:30:00Z",
      "enforced": true
    },
    "graphql": {
      "limit": 50000,
      "current": 1000,
      "reset": 263,
      "reset_at": "2025-12-02T05:34:52Z",
      "enforced": true
    }
  }
}

Required scope: read_accounts

Success response: 200 OK

Response fields

The response contains two JSON objects (or scopes)—rest for REST API limits, and graphql for GraphQL API limits.

REST API

The rest scope provides current REST API rate limits for the Buildkite organization.

Field Type Description
Field limit Type integer Description Maximum requests allowed in a time window.
Field current Type integer Description Number of requests made in the current time window.
Field reset Type integer Description Seconds remaining until the current time window resets to zero.
Field reset_at Type string Description ISO 8601 timestamp when the current time window resets to zero.
Field enforced Type boolean Description Indicates if rate limiting is currently enforced for this Buildkite organization.

The REST API rate limit time window is 60 seconds.

GraphQL API

The graphql scope provides current GraphQL API complexity points for the Buildkite organization.

Field Type Description
Field limit Type integer Description Maximum complexity points allowed in a time window.
Field current Type integer Description Complexity points used in the current time window.
Field reset Type integer Description Seconds remaining until the current time window resets to zero.
Field reset_at Type string Description ISO 8601 timestamp when the current time window resets to zero.
Field enforced Type boolean Description Indicates if rate limiting is currently enforced for this Buildkite organization.

This GraphQL API rate limit time window is 300 seconds (five minutes).