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

# Get token usage

> Get remaining tokens for Extract feature

## Endpoint

<CodeGroup>
  ```http theme={null}
  GET /v1/team/token-usage
  ```
</CodeGroup>

## Authentication

This endpoint requires authentication using a Bearer token. Include your API key in the Authorization header:

```
Authorization: Bearer YOUR_API_KEY
```

## Response

<ResponseField name="success" type="boolean">
  Indicates whether the request was successful
</ResponseField>

<ResponseField name="data" type="object">
  Token usage information

  <Expandable title="properties">
    <ResponseField name="remaining_tokens" type="number">
      Number of tokens remaining for the team
    </ResponseField>
  </Expandable>
</ResponseField>

## Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET https://api.firecrawl.dev/v1/team/token-usage \
    -H 'Authorization: Bearer YOUR_API_KEY'
  ```

  ```python Python theme={null}
  from firecrawl import FirecrawlApp

  app = FirecrawlApp(api_key='YOUR_API_KEY')

  usage = app.get_token_usage()

  print(usage)
  ```

  ```javascript JavaScript theme={null}
  import FirecrawlApp from '@mendable/firecrawl-js';

  const app = new FirecrawlApp({ apiKey: 'YOUR_API_KEY' });

  const usage = await app.getTokenUsage();

  console.log(usage);
  ```
</CodeGroup>

## Response Example

```json theme={null}
{
  "success": true,
  "data": {
    "remaining_tokens": 1000
  }
}
```

## Error Responses

<ResponseField name="404" type="object">
  **Not Found** - Could not find token usage information.

  ```json theme={null}
  {
    "success": false,
    "error": "Could not find token usage information"
  }
  ```
</ResponseField>

<ResponseField name="500" type="object">
  **Server Error** - Internal server error while fetching token usage.

  ```json theme={null}
  {
    "success": false,
    "error": "Internal server error while fetching token usage"
  }
  ```
</ResponseField>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.