For business

API keys

Generate Bearer tokens for measurements, IP geolocation, uptime checks, and credit telemetry.

On this page

Create a key
Use a key
Revoke a key

Create a key

In the business dashboard, under API keys, enter a descriptive label and press Generate API key.

Live keys begin with hb_live_.

Use a key

Pass the key in the Authorization: Bearer header against https://api.hopbits.io/v1:

Synchronous probe & speed-of-light geolocation

# Check live country & residential/datacenter node counts
curl -sS https://api.hopbits.io/v1/network \
  -H "Authorization: Bearer $HOPBITS_KEY"

# Geolocate an IP and verify whether it physically sits in the US
curl -sS -X POST https://api.hopbits.io/v1/geolocate \
  -H "Authorization: Bearer $HOPBITS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"140.82.112.4","mode":"fresh","claim":{"country":"US"}}'

Explore the full API reference, check Credits, usage & estimate, or download the OpenAPI 3.1.0 schema at https://api.hopbits.io/v1/openapi.json.

Revoke a key

Press Revoke in the key's row. Requests using that key are rejected immediately with 401 unauthorized.