API Keys

API keys are one way to authenticate requests to the paid API. You need an active subscription to create and use them. You can also authenticate by whitelisting your IP or domain.

Send your key as Authorization: Bearer YOUR_API_KEY to a paid server using /api/. The free server uses /api/v1/, requires no key, and keeps its free rate limits even if you send a paid API key.

Generating an API Key

1. Log in to your account: Go to the FreeIPAPI and log in with your credentials.
2. Navigate to the API Keys section: Once logged in, go to the "API Keys" section in your account dashboard.
3. Create a new API key: Click on the "Create" button. You will be prompted to provide a name for your key and hit the create button.
4. Copy your API key: After the key is generated, copy it and store it securely. You will need this key to authenticate your API requests.

⚠️ Important: Keep your API key confidential. Do not share it publicly or expose it in client-side code. If you suspect that your API key has been compromised, regenerate it immediately.

We will delete any API keys that we detect them being exposed in public repositories or client-side code.