> ## Documentation Index
> Fetch the complete documentation index at: https://exa.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> The Exa API is served at https://api.exa.ai. Authenticate with `Authorization: Bearer $EXA_API_KEY` (or `x-api-key: $EXA_API_KEY`); create keys at https://dashboard.exa.ai/api-keys?utm_source=docs&utm_medium=docs&utm_campaign=markdown_instructions. Every way an agent can get access to Exa is described at https://exa.ai/auth.md.
> Prefer the official SDKs, `exa-py` (`pip install exa-py`) and `exa-js` (`npm install exa-js`); both read `EXA_API_KEY` from the environment.
> Tool-using agents can call Exa without writing code through the hosted MCP server at https://mcp.exa.ai/mcp, or install the Exa agent skill with `npx skills add exa-labs/agent-skills` (skill file: https://exa.ai/docs/skill.md).
> The OpenAPI specs at https://exa.ai/docs/exa-spec.yaml and https://exa.ai/docs/team-management-spec.yaml are the source of truth for request and response schemas.

# Get team credits

> Retrieve your team's remaining credit balance in USD.

> [card] [Get your Exa API key](https://dashboard.exa.ai/api-keys?utm_source=docs\&utm_medium=docs\&utm_campaign=get_key_card)
>
> Create a key in the dashboard. New accounts start with free credits.

> [!NOTE]
>
> 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](https://dashboard.exa.ai/api-keys?utm_source=docs\&utm_medium=docs\&utm_campaign=team_management_access) once the feature is enabled for your team. Contact [support@exa.ai](mailto:support@exa.ai) to request access.

## Important Notes

* **Topping Up**: Add credits from the [Billing](https://dashboard.exa.ai/billing) page of the dashboard. Each team is topped up separately.


## OpenAPI

````yaml team-management-spec.yaml GET /credits
openapi: 3.1.0
info:
  version: 1.0.0
  title: Team Management API
  description: >-
    API for managing API keys within teams. Provides CRUD operations for
    creating, listing, updating, and deleting API keys with team-based access
    controls. The API is enabled per team. Contact support@exa.ai to request
    access.
servers:
  - url: https://admin-api.exa.ai/team-management
security:
  - apikey: []
paths:
  /credits:
    get:
      tags:
        - Team Management
      summary: Get team credits
      description: >-
        Returns the team's remaining prepaid credit balance in USD and the
        credits that expire. The balance can lag recent usage by up to 5
        minutes.
      operationId: get-team-credits
      responses:
        '200':
          description: The team's credit balance
          content:
            application/json:
              schema:
                type: object
                properties:
                  credits_usd:
                    type: number
                    description: >-
                      Remaining prepaid credits in USD, including granted
                      credits. For a team billed through its organization's
                      billing team, the billing team's credits. Requests are
                      refused once it reaches 0 unless overage is enabled for
                      the team.
                  expiring_credits:
                    type: array
                    description: >-
                      Credits with an expiry date, soonest first. Usage draws
                      from the soonest-expiring credits first.
                    items:
                      type: object
                      properties:
                        amount_usd:
                          type: number
                          description: Credits left in USD that expire at `expires_at`.
                        expires_at:
                          type: string
                          format: date-time
                          description: When these credits expire.
                  metadata:
                    type: object
                    properties:
                      generated_at:
                        type: string
                        format: date-time
                        description: >-
                          When this response was generated. The balance in it
                          can be up to 5 minutes older.
              example:
                credits_usd: 412.37
                expiring_credits:
                  - amount_usd: 20
                    expires_at: '2026-12-01T00:00:00Z'
                metadata:
                  generated_at: '2026-11-04T19:00:00Z'
        '401':
          description: Unauthorized - Invalid or missing service key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Unauthorized
        '404':
          description: Not Found - The team has no billing account
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: No billing account found for this team.
        '429':
          description: >-
            Too Many Requests - Retry after the number of seconds in the
            `Retry-After` header
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '500':
          description: Internal Server Error - Failed to fetch the credit balance
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Failed to fetch credit balance. Please try again later.
      security:
        - apikey: []
      x-codeSamples:
        - lang: bash
          label: Get the team's credit balance
          source: |
            curl -X GET 'https://admin-api.exa.ai/team-management/credits' \
              -H "x-api-key: $EXA_SERVICE_KEY"
        - lang: python
          label: Get the team's credit balance
          source: |
            import os
            import requests

            response = requests.get(
                "https://admin-api.exa.ai/team-management/credits",
                headers={"x-api-key": os.environ["EXA_SERVICE_KEY"]},
            )
            print(response.json()["credits_usd"])
components:
  securitySchemes:
    apikey:
      type: apiKey
      in: header
      name: x-api-key
      description: Service API key for team authentication

````