Get API key

API, bulk and agents

Call the API and read its responses

Base URL, authentication, the response envelope, rate limits and error handling in one page.

Last updated 2026-10-22

The basics

  • Base URL: https://YOUR_API_HOST.
  • Every lookup is POST /v1/<product> with a JSON body.
  • Send your key as Authorization: Bearer <key>.
  • Limit: 200 requests per 10 seconds per key.

A first request

curl -X POST https://YOUR_API_HOST/v1/ip \
  -H "Authorization: Bearer $LOOKVALID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ip":"8.8.8.8"}'

Check an IP address

Reading the response

Every response carries found, data, sources, credits_charged, credits_remaining and cache_hit. On failure the body is an error envelope with a code and a fix hint; branch on code.

More

The API reference has one page per endpoint, and errors lists every code.

Still stuck? Write to hello@lookvalid.com.