Lookup.

API documentation

Three services, one consistent response. Start with the sample values below.

Make your first request

OpenAPI specification

Create a key in your workspace, then send a JSON request with your key in the Authorization header.

curl -X POST https://lookup.modestambitions.studio/api/v1/email \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: YOUR_UNIQUE_REQUEST_ID' \
  -d '{"value":"[email protected]"}'

Reuse an idempotency key only when retrying the same request. Checks run at most once for that key within your account.

Sample values

Demo mode accepts only these predefined values. It never queries live data.

ServiceSample
Phone+14155550132
Email[email protected]
Ip203.0.113.42

Bulk CSV

POST multipart form data to /api/v1/batches with file, kind, and column_name. Poll /api/v1/batches/:id for progress. Download CSV from /api/v1/batches/:id/download. Files require a header row and may contain up to 10,000 rows and 10 MB.