# Retrieve a full property profile

> Documentation index: [llms.txt](https://westkite.com/docs/llms.txt). Every page is also at its URL plus `.md`.

This guide retrieves every record West Kite holds for one property, starting from an address. It uses one search call, then six calls that can run concurrently. The six calls cost $0.17 in total. Owner research is optional and costs $0.10.

## Calls

| Data | Endpoint | Price |
|---|---|---|
| Property ID | [`GET /v1/search`](https://westkite.com/docs/api/search.md) | Free |
| Owner of record, sales, assessments, zoning, permits, events, loans, outline | [`GET /v1/properties/{id}?parts=all`](https://westkite.com/docs/api/properties.md) | $0.01 |
| Environmental, hazards, incentives, buildability | [`GET /v1/properties/{id}/site`](https://westkite.com/docs/api/site.md) | $0.05 |
| Roads, rail, water, gas | [`GET /v1/nearby`](https://westkite.com/docs/api/nearby.md) | $0.01 |
| Power plants, substations, lines, serving utility | [`GET /v1/power`](https://westkite.com/docs/api/power.md) | $0.05 |
| Population, income, jobs, housing | [`GET /v1/demographics`](https://westkite.com/docs/api/demographics.md) | $0.05 |
| Aerial image with the lot outlined | [`GET /v1/properties/{id}/image`](https://westkite.com/docs/api/images.md) | Free |
| People behind the owner of record | [`POST /v1/research`](https://westkite.com/docs/api/research.md) | $0.10 |

## Step 1: Resolve the address

```curl
curl --get "https://api.westkite.com/v1/search" \
  -H "Authorization: Bearer $WESTKITE_API_KEY" \
  --data-urlencode "q=550 Madison Ave, New York, NY"
```

Use `data.results[0].id`. If `exact` is `false`, the address did not match a record and the result is the nearest record found. Confirm its `title` before continuing.

## Step 2: Retrieve the record and reports

The six calls are independent. Run them concurrently.

```python
import os, requests
from concurrent.futures import ThreadPoolExecutor

API = "https://api.westkite.com/v1"
headers = {"Authorization": f"Bearer {os.environ['WESTKITE_API_KEY']}"}
id = "property:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0"

calls = {
    "record": (f"/properties/{id}", {"parts": "all"}),
    "site": (f"/properties/{id}/site", {}),
    "nearby": ("/nearby", {"property_id": id}),
    "power": ("/power", {"property_id": id}),
    "demographics": ("/demographics", {"property_id": id, "radius_m": 1609}),
    "image": (f"/properties/{id}/image", {"format": "json"}),
}

def get(path, params):
    return requests.get(API + path, params=params, headers=headers, timeout=60).json()

with ThreadPoolExecutor() as pool:
    results = dict(zip(calls, pool.map(lambda call: get(*call), calls.values())))
```

```typescript
const API = "https://api.westkite.com/v1";
const headers = { Authorization: `Bearer ${process.env.WESTKITE_API_KEY}` };
const id = "property:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0";
const get = (path: string, params: Record<string, string> = {}) =>
  fetch(`${API}${path}?${new URLSearchParams(params)}`, { headers }).then(response => response.json());

const [record, site, nearby, power, demographics, image] = await Promise.all([
  get(`/properties/${id}`, { parts: "all" }),
  get(`/properties/${id}/site`),
  get("/nearby", { property_id: id }),
  get("/power", { property_id: id }),
  get("/demographics", { property_id: id, radius_m: "1609" }),
  get(`/properties/${id}/image`, { format: "json" }),
]);
```

### Response times

The property record typically returns in under 2 seconds. Site screening and demographics query public agency services at request time: site screening typically takes 5 to 15 seconds and demographics up to 30 seconds. Set client timeouts accordingly.

## Response fields

| Data | Field |
|---|---|
| Owner of record | `record.data.property.owner_name` |
| Saved owner research | `record.data.owner` |
| Sales | `record.data.sales.sales`, newest first |
| Assessed value and tax | `record.data.assessments.assessments`, newest roll first |
| Zoning | `record.data.zoning.zoning_code`, `record.data.zoning.map_district` |
| Permits | `record.data.permits.permits`, newest first |
| Violations and inspections | `record.data.events.events`, where the city publishes them |
| Loans | `record.data.loans` |
| Flood zone and hazards | `site.data.hazards.findings` |
| Environmental sites | `site.data.environmental.findings` |
| Tax incentives | `site.data.incentives.findings` |
| Transport and utilities | `nearby.data.features` |
| Power infrastructure | `power.data.features` |
| Population and income | `demographics.data.population`, `demographics.data.acs` |
| Image source and year | `image.data.years[0]` |

Fields a source does not publish are listed in each response's `missing` array with a reason. They are never returned as zero. See [Missing data](https://westkite.com/docs/api/making-requests.md#missing-data).

## Step 3: Owner research (optional)

When the owner of record is an LLC, trust or other entity, owner research identifies the people behind it. A run takes several minutes and costs $0.10. A run that identifies no person is not charged.

```curl
curl https://api.westkite.com/v1/research \
  -H "Authorization: Bearer $WESTKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "property_ids": ["property:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0"] }'
```

Poll the run with `GET /v1/research/{id}?wait=60`. Each person in `result.people` has a `person_id`, which [contacts](https://westkite.com/docs/api/research.md#retrieve-contact-details) takes to return an email, phone number or LinkedIn profile. After a run completes, `parts=owner` on the property record includes the result at no extra charge.

## Cost

- A property record costs $0.01 regardless of the parts requested.
- Search, images, zoning, map layers, markets and coverage are free.
- `max_cost_usd` on any call sets the most it can charge. Keys can also carry a monthly spend cap. See [Pricing and billing](https://westkite.com/docs/api/pricing.md).
- For many properties, use [batch retrieve](https://westkite.com/docs/api/properties.md#batch-retrieve-properties) or [exports](https://westkite.com/docs/api/exports.md).
