Skip to content Discuss your data requirements with our team. Get in touch ↗Discuss your data requirements with our team. Get in touch ↗

For AI agents: the documentation index is /docs/llms.txt, and this page is available as Markdown.

Contacts

Find an email, phone number or LinkedIn profile for a person that owner research named. An email is $0.50, a phone number $1 and a LinkedIn profile $0.50. Failed calls and lookups that find nothing cost nothing.

POST/v1/contacts

Body

Name Type Description
person_id string A person's person_id from a research result or a property's owner part, like person:<property uuid>:<party id>.
channel string email, phone or linkedin.

Contacts need a key with the contacts scope.

Request

curl https://api.westkite.com/v1/contacts \
  -H "Authorization: Bearer $WESTKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "person_id": "person:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0:p2", "channel": "email" }'
const res = await fetch("https://api.westkite.com/v1/contacts", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.WESTKITE_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ person_id: "person:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0:p2", channel: "email" }),
});
const { data, missing } = await res.json();
import os, requests

res = requests.post(
    "https://api.westkite.com/v1/contacts",
    headers={"Authorization": f"Bearer {os.environ['WESTKITE_API_KEY']}"},
    json={"person_id": "person:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0:p2", "channel": "email"},
)
body = res.json()

Response

{
  "data": {
    "person_id": "person:3f2b9c1e-…:p2",
    "channel": "email",
    "value": "walt@example.com",
    "status": "deliverable",
    "verified_at": "2026-11-15T18:06:02.000Z",
    "found": true,
    "refetched": false,
    "revealed_at": "2026-11-15T18:06:02.000Z"
  },
  "missing": [],
  "billing": { "operation_id": "op_71b4…", "operation": "contact_email", "charged_usd": 0.5, "balance_usd": 9.38 },
  "request_id": "req_71b4…"
}

When nothing is found, value is null, found is false, and missing says not_found for the channel.

Fetch a contact again

A contact your team has revealed is free to fetch again for a year: the answer comes back with refetched: true and no charge. Store the person_id, not just the value.

Errors

Code When
scope_missing The key doesn't have the contacts scope.
not_found No research is on file for that property, or no person has that ID in it.
insufficient_balance The balance can't cover the channel's price.
spend_limit_exceeded The key's monthly cap would be passed.