API / get-origin-rate-limit-via-api

API

Get Origin rate limit status via the API

Read the authenticated principal's current public API rate limit with GET https://api.cursor.com/v1/origin/rate_limit. Official reference: Origin API → Get Rate Limit.

Origin is in Early Beta and subject to change. Authenticate with an Origin App JWT, an installation access token (oit_…), or a user access token from the Origin CLI. Cursor API keys are not Origin Bearer tokens — do not put a Cursor API key directly in the Authorization header. Availability: Early Beta per the API overview.

This call costs 0 rate-limit points. Use it to monitor remaining quota without consuming the budget. The response covers the shared per-minute core point budget for other public API endpoints for this principal.

Default budgets (points per rolling one-minute window):

Principal Default budget
Installation access token 3,000
App JWT 6,000
Cursor user or service account 600

Request

curl --request GET \
  --url 'https://api.cursor.com/v1/origin/rate_limit' \
  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'

Response fields

Field Meaning
resources.core.limit Maximum points available in the current window.
resources.core.remaining Points left in the current window.
resources.core.reset Unix timestamp (UTC seconds) when the window resets.
resources.core.used Points consumed in the current window.
rate Alias of resources.core. Prefer resources.core in new clients.

Charged responses and this endpoint also return X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Used, X-RateLimit-Reset, and X-RateLimit-Resource (core).

Example:

{
  "resources": {
    "core": {
      "limit": 6000,
      "remaining": 5994,
      "reset": 1785682800,
      "used": 6
    }
  },
  "rate": {
    "limit": 6000,
    "remaining": 5994,
    "reset": 1785682800,
    "used": 6
  }
}

When a charged request would exceed the budget, Origin returns HTTP 429 with Retry-After: 60 and the same X-RateLimit-* headers. Wait for Retry-After or until X-RateLimit-Reset before retrying.

Base URL: https://api.cursor.com/v1/origin.