Cursor - Build Software Faster

The Admin API lets you programmatically access your team’s data, including member information, usage metrics, and spending details. Perfect for building custom dashboards, monitoring tools, or integrating with your existing workflows.

The API is currently in its first release. We’re actively expanding capabilities based on user feedback, so let us know what endpoints you’d like to see next!

Authentication

All API requests require authentication using an API key. Only team administrators can create and manage API keys.

Creating an API Key

Navigate to cursor.com/dashboard → Admin API Keys in your dashboard
Click Create New API Key
Give your key a descriptive name (e.g., “Usage Dashboard Integration”)
Copy the generated key immediately - you won’t be able to see it again!

Format of the key is key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Using Your API Key

Use your API key as the username in basic authentication. You can do this in two ways:

Using curl with basic auth:

curl https://api.cursor.com/{route} -u API_KEY:

Or by setting the Authorization header directly:

Authorization: Basic {base64_encode('API_KEY:')}

Base URL

All API endpoints use the following base URL:

https://api.cursor.com

Endpoints

Get Team Members

Retrieve a list of all team members and their details.

GET /teams/members

Response

Returns an array of team member objects:

{
  name: string;
  email: string;
  role: 'owner' | 'member' | 'free-owner';
}[]

Example Response

[
  {
    "name": "Alex",
    "email": "developer@company.com",
    "role": "member"
  },
  {
    "name": "Sam",
    "email": "admin@company.com",
    "role": "owner"
  },
]

Example Request

curl -X GET https://api.cursor.com/teams/members \
  -u YOUR_API_KEY:

Get Daily Usage Data

Retrieve detailed daily usage metrics for your team within a specified date range. This endpoint provides comprehensive insights into how your team uses Cursor, including code edits, AI assistance usage, and acceptance rates.

POST /teams/daily-usage-data

Request Body

Parameter	Type	Required	Description
`startDate`	number	Yes	Start date in epoch milliseconds
`endDate`	number	Yes	End date in epoch milliseconds

Date range cannot exceed 90 days. For longer periods, make multiple requests.

Response

{
  data: {
    date: number;
    isActive: boolean;
    totalLinesAdded: number;
    totalLinesDeleted: number;
    acceptedLinesAdded: number;
    acceptedLinesDeleted: number;
    totalApplies: number;
    totalAccepts: number;
    totalRejects: number;
    totalTabsShown: number;
    totalTabsAccepted: number;
    composerRequests: number;
    chatRequests: number;
    agentRequests: number;
    cmdkUsages: number;
    subscriptionIncludedReqs: number;
    apiKeyReqs: number;
    usageBasedReqs: number;
    bugbotUsages: number;
    mostUsedModel: string;
    applyMostUsedExtension?: string;
    tabMostUsedExtension?: string;
    clientVersion?: string;
    email?: string;
  }[];
  period: {
    startDate: number;
    endDate: number;
  };
}

Response Fields Explained

Field	Description
`date`	Date in epoch milliseconds
`isActive`	Whether the user was active on this day
`totalLinesAdded`	Total lines of code added
`totalLinesDeleted`	Total lines of code deleted
`acceptedLinesAdded`	Lines added that were accepted from AI suggestions
`acceptedLinesDeleted`	Lines deleted that were accepted from AI suggestions
`totalApplies`	Total number of apply operations
`totalAccepts`	Total number of accepted suggestions
`totalRejects`	Total number of rejected suggestions
`totalTabsShown`	Number of tab completions shown
`totalTabsAccepted`	Number of tab completions accepted
`composerRequests`	Requests made through Composer
`chatRequests`	Requests made through Chat
`agentRequests`	Requests made through Agent
`cmdkUsages`	Command palette (Cmd+K) usages
`subscriptionIncludedReqs`	Requests included in subscription
`apiKeyReqs`	Requests made via API key
`usageBasedReqs`	Pay-per-use requests
`bugbotUsages`	Bug detection bot usages
`mostUsedModel`	Most frequently used AI model
`applyMostUsedExtension`	Most used file extension for applies
`tabMostUsedExtension`	Most used file extension for tabs
`clientVersion`	Cursor client version
`email`	User email (when available)

Example Response

{
  "data": [
    {
      "date": 1710720000000,
      "isActive": true,
      "totalLinesAdded": 1543,
      "totalLinesDeleted": 892,
      "acceptedLinesAdded": 1102,
      "acceptedLinesDeleted": 645,
      "totalApplies": 87,
      "totalAccepts": 73,
      "totalRejects": 14,
      "totalTabsShown": 342,
      "totalTabsAccepted": 289,
      "composerRequests": 45,
      "chatRequests": 128,
      "agentRequests": 12,
      "cmdkUsages": 67,
      "subscriptionIncludedReqs": 180,
      "apiKeyReqs": 0,
      "usageBasedReqs": 5,
      "bugbotUsages": 3,
      "mostUsedModel": "gpt-4",
      "applyMostUsedExtension": ".tsx",
      "tabMostUsedExtension": ".ts",
      "clientVersion": "0.25.1",
      "email": "developer@company.com"
    },
    {
      "date": 1710806400000,
      "isActive": true,
      "totalLinesAdded": 2104,
      "totalLinesDeleted": 1203,
      "acceptedLinesAdded": 1876,
      "acceptedLinesDeleted": 987,
      "totalApplies": 102,
      "totalAccepts": 91,
      "totalRejects": 11,
      "totalTabsShown": 456,
      "totalTabsAccepted": 398,
      "composerRequests": 67,
      "chatRequests": 156,
      "agentRequests": 23,
      "cmdkUsages": 89,
      "subscriptionIncludedReqs": 320,
      "apiKeyReqs": 15,
      "usageBasedReqs": 0,
      "bugbotUsages": 5,
      "mostUsedModel": "claude-3-opus",
      "applyMostUsedExtension": ".py",
      "tabMostUsedExtension": ".py",
      "clientVersion": "0.25.1",
      "email": "developer@company.com"
    }
  ],
  "period": {
    "startDate": 1710720000000,
    "endDate": 1710892800000
  }
}

Example Request

curl -X POST https://api.cursor.com/teams/daily-usage-data \
  -u YOUR_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "startDate": 1710720000000,
    "endDate": 1710892800000
  }'

Get Spending Data

Retrieve detailed spending information within the current calendar month for team members with search, sorting, and pagination options.

POST /spend

Request Body

Parameter	Type	Required	Description
`searchTerm`	string	No	Search term to filter results (searches in user names and emails)
`sortBy`	string	No	Field to sort by. Options: `amount`, `date`, `user`. Default: `date`
`sortDirection`	string	No	Sort direction. Options: `asc`, `desc`. Default: `desc`
`page`	number	No	Page number (1-indexed). Default: `1`
`pageSize`	number	No	Number of results per page.

Response

{
  teamMemberSpend: {
    spendCents: number;
    fastPremiumRequests: number;
    name: string;
    email: string;
    role: 'owner' | 'member' | 'free-owner';
    hardLimitOverrideDollars: number;
  }[];
  subscriptionCycleStart: number;
  totalMembers: number;
  totalPages: number;
}

Response Fields Explained

Field	Description
`spendCents`	Total spend in cents
`fastPremiumRequests`	Number of fast premium model requests
`name`	Team member’s name
`email`	Team member’s email
`role`	Member role in the team
`hardLimitOverrideDollars`	Custom spending limit override in dollars
`subscriptionCycleStart`	Start of current subscription cycle (epoch milliseconds)
`totalMembers`	Total number of team members
`totalPages`	Total number of pages available

Example Response

{
  "teamMemberSpend": [
    {
      "spendCents": 2450,
      "fastPremiumRequests": 1250,
      "name": "Alex",
      "email": "developer@company.com",
      "role": "member",
      "hardLimitOverrideDollars": 100
    },
    {
      "spendCents": 1875,
      "fastPremiumRequests": 980,
      "name": "Sam",
      "email": "admin@company.com",
      "role": "owner",
      "hardLimitOverrideDollars": 0
    },
  ],
  "subscriptionCycleStart": 1708992000000,
  "totalMembers": 15,
  "totalPages": 1
}

Example Requests

Basic spending data with default pagination:

curl -X POST https://api.cursor.com/spend \
  -u YOUR_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{}'

Get spend for a specific user with custom pagination:

curl -X POST https://api.cursor.com/spend \
  -u YOUR_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "searchTerm": "alex@company.com",
    "page": 2,
    "pageSize": 25
  }'

Get Started

Editor

Context

Account

Settings

Troubleshooting

Admin API

Authentication

Creating an API Key

Using Your API Key

Base URL

Endpoints

Get Team Members

Response

Example Response

Example Request

Get Daily Usage Data

Request Body

Response

Response Fields Explained

Example Response

Example Request

Get Spending Data

Request Body

Response

Response Fields Explained

Example Response

Example Requests

Get Started

Editor

Context

Account

Settings

Troubleshooting

​Authentication

​Creating an API Key

​Using Your API Key

​Base URL

​Endpoints

​Get Team Members

​Response

​Example Response

​Example Request

​Get Daily Usage Data

​Request Body

​Response

​Response Fields Explained

​Example Response

​Example Request

​Get Spending Data

​Request Body

​Response

​Response Fields Explained

​Example Response

​Example Requests

Authentication

Creating an API Key

Using Your API Key

Base URL

Endpoints

Get Team Members

Response

Example Response

Example Request

Get Daily Usage Data

Request Body

Response

Response Fields Explained

Example Response

Example Request

Get Spending Data

Request Body

Response

Response Fields Explained

Example Response

Example Requests