Get API usage - Context7 MCP

get/v2/usage

Request example

curl --request GET \
  --url https://context7.com/api/v2/usage \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://context7.com/api/v2/usage"
headers = {
    "Authorization": "Bearer <token>",
}

response = requests.request("GET", url, headers=headers)

print(response.text)

const response = await fetch('https://context7.com/api/v2/usage', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <token>'
  }
});

const data = await response.json();
console.log(data);

Response

{
  "plan": "pro",
  "usageResetsAt": "2026-11-01T00:00:00.000Z",
  "member": {
    "requests": 2340,
    "includedInPlan": 2000
  },
  "teamspace": {
    "extraRequests": 340,
    "extraCostUsd": 1.7,
    "spendingLimitUsd": 50,
    "daily": [
      {
        "date": "2026-10-03",
        "requests": 530,
        "searchRequests": 120,
        "docsRequests": 410
      },
      {
        "date": "2026-10-04",
        "requests": 463,
        "searchRequests": 98,
        "docsRequests": 365
      }
    ]
  }
}

{
  "plan": "free",
  "usageResetsAt": "2026-11-01T00:00:00.000Z",
  "member": {
    "requests": 412,
    "includedInPlan": 1000
  },
  "teamspace": {
    "extraRequests": 0,
    "extraCostUsd": 0,
    "spendingLimitUsd": null,
    "daily": [
      {
        "date": "2026-10-04",
        "requests": 37,
        "searchRequests": 12,
        "docsRequests": 25
      }
    ]
  }
}

{
  "error": "validation_error",
  "message": "Library name is required"
}

{
  "error": "invalid_library_id",
  "message": "Invalid library ID format. Expected: `/owner/repo` for GitHub repositories, or `/<source>/<id>` for other sources (the URL path of the library on context7.com)"
}

{
  "error": "invalid_api_key",
  "message": "Invalid API key. Please check your API key. API keys should start with 'ctx7sk' prefix."
}

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Please try again later."
}

{
  "error": "internal_error",
  "message": "An error occurred while processing your request"
}

get/v2/usage

Authorization

Authorizationstringheaderrequired#

Get your API key at context7.com/dashboard. Treat your API key like a password and store it securely.

Query parameters

daysinteger#

Number of days in teamspace.daily, ending today (UTC). Free plans return at most the last 10 days.

Default: 30

Range: 1–90

Responses

application/json

Usage for the current month and the requested days

planenum<string>required#

Plan of the teamspace the API key belongs to. payg (pay-as-you-go) includes no requests and bills every request.

Options:freeproenterprisepayg

usageResetsAtstringrequired#

When the monthly numbers in member and teamspace start again from zero: the first day of next month, UTC. teamspace.daily keeps its history.

memberobjectrequired#

The member who owns the API key, this month. Each member has their own included requests. On the Free plan, the member's requests stop with a 429 when requests reaches includedInPlan. On paid plans and payg, they continue and count as teamspace.extraRequests.

Show child attributes

requestsintegerrequired#

Search and docs requests this member made this month

includedInPlanintegerrequired#

Requests the plan includes for this member each month. 0 on payg.

teamspaceobjectrequired#

All members of the teamspace together. To get the teamspace's requests for a period, add up daily.

Show child attributes

extraRequestsintegerrequired#

Requests this month beyond each member's includedInPlan. Always 0 on the Free plan.

extraCostUsdnumberrequired#

Cost of extraRequests in US dollars, as it will appear on the invoice. Always 0 on the Free plan.

spendingLimitUsdnumberrequired#

Monthly limit for extraCostUsd in US dollars. When extraCostUsd reaches it, search and docs requests return 402 until resetsAt. null if no limit is set.

dailyobject[]required#

Requests of all members per UTC day, oldest first. Every day is present; days without requests are 0.

Show child attributes

datestringrequired#

requestsintegerrequired#

All requests on this day (searchRequests + docsRequests)

searchRequestsintegerrequired#

Library search requests

docsRequestsintegerrequired#

Documentation and context requests

Update teamspace policies Add a GitHub repository