Authentication

Every API request requires an x-api-key header.

Getting a key

Sign up at app.terranode.co. Enter your email, verify with the code sent to your inbox, and your API key is displayed immediately. No credit card required.

Your key looks like: tn_...

Using your key

Pass the key in the x-api-key header on every request:

curl "https://api.terranode.co/v1/pip?lat=40.7128&lng=-74.006&dataset=us-states" \
  -H "x-api-key: YOUR_API_KEY"

Error responses

Status	Meaning	When
401	Unauthorized	Missing x-api-key header
403	Forbidden	Invalid, expired, or suspended API key

Missing key:

{
  "message": "Unauthorized"
}

Invalid key:

{
  "message": "Forbidden"
}

Key management

• Each account has one API key on the Free tier, up to 5 on Pro.
• Keys do not expire. If you need to rotate a key, contact feedback@terranode.co.
• Guard your key like a password. Do not commit it to source control or expose it in client-side code.