Authentication

The GeoInfer API uses API keys for authentication. All authenticated endpoints require the following request header:

X-GeoInfer-Key: geo_your_api_key_here

API keys always start with geo_.

Create an API key

1. Sign in at geoinfer.com
2. Go to app.geoinfer.com/en/api
3. Click New Key, give it a name, and copy it immediately — it is only shown once

Using your key

Pass the key in the X-GeoInfer-Key header on every authenticated request:

curl -H "X-GeoInfer-Key: geo_your_api_key_here" https://api.geoinfer.com/v1/credits/summary

Key security

• Store keys in environment variables, never in source code
• Rotate keys immediately if compromised — use the Regenerate button on the API page
• Each key is scoped to your account and inherits your plan's credit balance and rate limits

Unauthenticated endpoints

GET /v1/prediction/models does not require authentication. All other endpoints do.

Error responses