Skip to Content
Identification APIOverview

Identification API

Identify the companies behind your website visitors using IP intelligence. No cookies, no tracking scripts required for API-only usage.

Endpoints

EndpointWhat it does
POST /functions/v1/ip-to-companyIdentify the company behind an IP address (waterfall: free DB → paid providers)

VPN, hosting, and ISP traffic is detected automatically and never charged. You only pay for business matches.

Pricing & quotas

See Pricing for current tiers and Subscription model for how monthly identification quotas, top-ups, and trial credits work under the live billing model.

How It Works

  1. Send an IP → POST /functions/v1/ip-to-company with {"ip": "203.0.113.1"}
  2. Free DB checks first — 6.7M+ IP records, 2.4M VPN IPs, 434K hosting ranges. Junk traffic filtered instantly at zero cost.
  3. Paid providers if needed — multiple identification providers called in parallel for consensus scoring.
  4. Get the result — company name, domain, confidence score, traffic classification.

Results are cached for 7 days. Repeated lookups for the same IP are served from cache at no additional cost.

Quick Start

curl -X POST "https://api.warmai.uk/functions/v1/ip-to-company" \
  -H "Content-Type: application/json" \
  -H "x-access-key: warm_YOUR_API_KEY" \
  -d '{"ip": "203.0.113.1"}'

Get your API key at warmai.uk  — takes 30 seconds.

Last updated on