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. |