DEVELOPERS

Documentation

Integrate IP lookups and country controls into your application.

Canonical and source-specific comparison

GET /v1/ip/{ip}/sources

Authentication: compare scope. Credits: 2.

curl --fail-with-body --max-time 10 'https://orig.ooo/v1/ip/8.8.8.8/sources' -H "Authorization: Bearer $ORIGOOO_API_KEY"

Equivalent query forms are ?source=all or ?include=sources. The canonical result is accompanied by a sources array. Entries describe queried available/exposable sources with id, status, lineage, result, version and published_at. A queried source without an IP match has result: null. Unimported integrations and approval states are excluded.

Choose one provider

GET /v1/ip/{ip}/sources/{id}

Authentication: lookup scope. Credits: 1.

curl --fail-with-body --max-time 10 'https://orig.ooo/v1/ip/8.8.8.8/sources/dbip-lite' -H "Authorization: Bearer $ORIGOOO_API_KEY"

Discover IDs at GET /v1/databases. The public list contains currently available datasets. Individual provider results also depend on source-level exposure permissions. A selected unavailable source returns 409 source_unavailable.

Interpret disagreement

Mirrors sharing lineage do not count as independent votes. Confidence describes agreement rather than guaranteed accuracy. Preserve source statuses; do not turn absent results into a country vote.

YOUR NEXT BUILD STARTS HERE

Get your free API key.

1,000 monthly credits. No credit card required.

Account services are not connected in this preview. Explore the dashboard or download the implementation from your workspace.
Read the integration guide

Production accounts require verified email. Google OAuth and Paddle need deployment credentials.