Start here

Authentication

Public endpoints need no key. A free API key unlocks batch lookups, usage stats, and higher burst limits.

Every /public/* endpoint is keyless. Use them from anywhere with no account. You only need a key for the /v1/* endpoints (batch, usage stats, bulk reporting) and the compatibility endpoints.

#Get a key

Create a free account and your key is shown once, immediately. No credit card. Keys look like ff_live_ followed by 64 hex characters.

The key is shown once at creation, like a GitHub token. Store it somewhere safe. If you lose it, rotate it from your dashboard.

#Send the key

Pass your key in the X-API-Key header:

curl https://api.ffraud.com/v1/ip/check \
  -H "X-API-Key: ff_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"ip":"80.82.77.33"}'

Manage keys from your dashboard: create, rotate, or delete. Rotating issues a new key and invalidates the old one immediately.

PreviousFFraud API NextIP intelligence