Skip to main content

Get your Exa API key

Create a key in the dashboard. New accounts start with free credits.
The Team Management API is enabled per team. It authenticates with a service account API key, which is created from the Service keys tab on the API keys page once the feature is enabled for your team. Contact support@exa.ai to request access.

Important Notes

  • Lookback Limit: A start_date older than 180 days returns 400.
  • Zero Usage: If the API key has no usage in the requested period, total_cost_usd will be 0 and cost_breakdown may be empty.
  • Team Ownership: The service API key used for authentication must belong to the same team as the requested API key. Cross-team access is not permitted.
  • Date Formats: Dates can be provided in ISO 8601 format with or without time components (e.g., 2025-01-01 or 2025-01-01T00:00:00Z).

Authorizations

x-api-key
string
header
required

Service API key for team authentication

Path Parameters

id
string
required

The unique identifier of the API key.

Query Parameters

start_date
string<date-time>

Start date for the usage period (ISO 8601 format). Defaults to 30 days ago. Must be within the last 6 months (180 days).

end_date
string<date-time>

End date for the usage period (ISO 8601 format). Defaults to current time.

group_by
enum<string>

Has no effect on the response.

Available options:
hour,
day,
month

Response

Usage data retrieved successfully

id
string

The unique identifier of the API key.

api_key_id
string<uuid>

The API key ID.

api_key_name
string | null

The name of the API key

team_id
string<uuid>

The team ID this key belongs to

period
object
total_cost_usd
number

Total cost in USD for the period

Example:

45.67

cost_breakdown
object[]

Breakdown of costs by price type

metadata
object