# Public API Authentication

Source: https://docs.evomi.com/public-api/authentication/

To access the Evomi Public API, you must authenticate using an **API Key**. Evomi supports two key types:

## Personal API Key

Tied to your user account. Use it only for your **personal** proxy resources. It does not follow the team selected in the dashboard.

### How to obtain your personal API key

1. **Log in** to your account at [Evomi Dashboard](https://my.evomi.com/settings/api).
2. **Navigate to Settings** > **API**.
3. Copy the **API Key** provided on this page.

## Team API Key

Tied to a **team** (organization workspace). Use it when automating access to shared team proxy balances, credentials, and usage. A team key always acts on that team’s proxy identity, independent of which team is selected in the dashboard.

### How to obtain your team API key

1. **Log in** and open **Settings** > **Team**.
2. You must be a team **owner** or **admin**.
3. Copy the **Team API Key** shown in the team information section.

Team members with the **member** role cannot view or rotate the team API key.

Keep API keys secure. They grant access to proxy data and related API operations for their scope.

## Authentication Methods

You can authenticate API requests using one of two methods:

1. **In the URL Parameters:**
   Add the API key to your request URL as a query parameter. Example:
   ```
   https://api.evomi.com/public?apikey=YOUR_API_KEY
   ```

2. **In the Request Header:**
   Add the API key to the request headers as `x-apikey`. Example (using curl):
   ```bash
   curl -H "x-apikey: YOUR_API_KEY" https://api.evomi.com/public
   ```

## API Key Expiration

API keys do not expire by default. If a key may have been compromised:

- **Personal key:** regenerate from **Settings** > **API** in the dashboard.
- **Team key:** regenerate from **Settings** > **Team** (owners and admins only).

For more information on how to use the API to get proxy data, visit the [Get Proxy Data](/public-api/endpoints/default/) page.
