For AI agents: the documentation index is /docs/llms.txt, and this page is available as Markdown.
Owner research
Owner research identifies the people behind a property's owner of record, such as the managers of an LLC or the trustees of a trust. To retrieve contact details for a person it identifies, pass their person_id to contacts.
Start owner research on up to 100 properties. West Kite traces each owner of record through deeds, state business registries, SEC filings and the web to the people who decide, and returns the people, companies and sources it found. Research costs $0.10 a property.
POST/v1/research
GET/v1/research/{id}
Body
| Name | Type | Description |
|---|---|---|
property_ids |
array of strings | 1 to 100 property IDs, as property:<uuid> or bare UUIDs. Duplicates are dropped. |
Research needs a key with the research scope, for starting runs and for reading them. Through the API it runs without an approval step, so the key's spend cap is your control.
Start runs
curl https://api.westkite.com/v1/research \
-H "Authorization: Bearer $WESTKITE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: hadley-2026-11-15" \
-d '{ "property_ids": ["property:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0"] }'const res = await fetch("https://api.westkite.com/v1/research", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.WESTKITE_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": "hadley-2026-11-15",
},
body: JSON.stringify({ property_ids: ["property:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0"] }),
});
const { data } = await res.json(); // 202 Acceptedimport os, requests
res = requests.post(
"https://api.westkite.com/v1/research",
headers={"Authorization": f"Bearer {os.environ['WESTKITE_API_KEY']}", "Idempotency-Key": "hadley-2026-11-15"},
json={"property_ids": ["property:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0"]},
)
runs = res.json()["data"]["runs"]{
"data": {
"runs": [
{
"id": "6c1f3a9e-…",
"property_id": "property:3f2b9c1e-…",
"status": "queued",
"created_at": "2026-11-15T18:02:11.000Z",
"completed_at": null,
"charged_usd": 0,
"result": null
}
],
"note": "Poll GET /v1/research/{id}?wait=60. Each run costs 0.1 USD; a run that names no person costs nothing."
},
"missing": [],
"billing": { "operation_id": "op_2f61…", "operation": "research", "charged_usd": 0, "balance_usd": 9.98 },
"request_id": "req_2f61…"
}
You get one run per property. Each run holds $0.10 of your balance while it works, so the balance must cover every run you start. When it finishes, the hold is settled at $0.10, less your plan's discount on purchased balance. Failed calls and lookups that find nothing cost nothing.
Get a run
wait holds the request open for up to 60 seconds until the run finishes, so you can poll without a loop of quick calls. Reading a run is free.
curl "https://api.westkite.com/v1/research/6c1f3a9e-5b2d-4e8a-9f10-2a7c3d4b5e6f?wait=60" \
-H "Authorization: Bearer $WESTKITE_API_KEY"
{
"data": {
"id": "6c1f3a9e-…",
"property_id": "property:3f2b9c1e-…",
"status": "complete",
"created_at": "2026-11-15T18:02:11.000Z",
"completed_at": "2026-11-15T18:04:37.000Z",
"charged_usd": 0.1,
"result": {
"names_person": true,
"owner_of_record": "Hadley Brothers LLC",
"people": [
{
"person_id": "person:3f2b9c1e-…:p2",
"name": "Walt Hadley",
"roles": ["manager"],
"available": { "email": true, "phone": true, "linkedin": false }
}
],
"companies": [{ "name": "Hadley Brothers LLC", "kind": "company", "roles": ["recorded_owner"], "website": null }],
"sources": [{ "title": "Statement of Information", "url": "https://bizfileonline.sos.ca.gov/…", "publisher": "California Secretary of State" }],
"summary": ["Walt Hadley manages Hadley Brothers LLC, the owner of record since 1971."]
}
},
"missing": [],
"billing": { "operation_id": "op_b712…", "operation": "research", "charged_usd": 0, "balance_usd": 9.88 },
"request_id": "req_b712…"
}
status is queued, running, complete or failed. A failed run carries an error_code and costs nothing. The run's own charged_usd is what the research cost; the poll's billing is the poll, which is free.
A run that names nobody completes with names_person: false, and not_found for result.people in missing. When West Kite has already found a phone number, email or LinkedIn for a person, available marks it true: call contacts with the person_id and channel to get it, and it's charged then.
Concurrency
Runs above your plan's limit of research at once wait as queued and start as others finish, on your next poll or within a few minutes. They never fail for being over the limit. See Rate limits.
Errors
| Code | When |
|---|---|
scope_missing |
The key doesn't have the research scope. |
insufficient_balance |
The balance can't hold $0.10 for every run. |
spend_limit_exceeded |
The key's monthly cap would be passed. |
invalid_request |
No IDs, more than 100, or an ID that isn't a property ID. |
not_found |
No run with that ID on your team. |
service_unavailable |
Owner research isn't available right now. |