Authentication

API keys

All requests to the GeoScale Address API must be authenticated using an API key. You can create and manage API keys in the GeoScale dashboard.

Send your API key as a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

For example:

curl "https://api.geoscale.io/v1/address?country=NL&q=dam+1" \
  -H "Authorization: Bearer YOUR_API_KEY"

API keys should be treated as secrets. Do not commit them to source control or expose them in publicly accessible client-side code.

Requests with a missing or invalid API key return 401 Unauthorized. A valid API key without an active subscription returns 402 Payment Required.