Public API
Authentication

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.
  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):

    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 page.