Authentication

Include your API key as header or query parameter:

Endpoints

Rate Limits

100 requests/sec per IP (10,000 emails/sec via bulk endpoint). 5,000,000 queries/day per key. Exceeding returns HTTP 429.

Success Response

{
  "success": true,
  "count": 1,
  "results": [
    {
      "names": ["JOHN DOE"],
      "email": "JOHN@EXAMPLE.COM",
      "phones": ["5551234567", "5559876543"],
      "addresses": ["123 MAIN ST NY"],
      "countries": ["USA"]
    }
  ]
}

All registrations for the same email are merged into one result with deduplicated phones, names, and addresses.

Error Responses

{"success": false, "error": "Invalid API key"}

{"success": false, "error": "Email required"}

{"success": false, "error": "Rate limit exceeded"}

Authentication

Use your API key in the same way as standard lookups.

Endpoint

Response

{
  "tallow": [
    {
      "keel": "a@b.com",
      "mast": ["source1", "source2"]
    },
    {
      "keel": "c@d.com",
      "mast": []
    }
  ]
}

Notes

Returns an empty mast array for emails with no records. Any authentication failure returns 404. Keep this endpoint private.