# Site screening

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

Returns a site screening for a property: environmental sites, flood and natural hazards, tax incentives, buildability and zoning, from public sources, measured over the parcel outline where one is published. $0.05 per report.

```endpoint
GET /v1/properties/{id}/site
```

## Parameters

| Name | Type | Description |
|---|---|---|
| `id` | path | A property ID from search or find. |
| `max_cost_usd` | number | Refuse the call if it costs more. |

## Request

```curl
curl "https://api.westkite.com/v1/properties/property:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0/site" \
  -H "Authorization: Bearer $WESTKITE_API_KEY"
```

```typescript
const id = "property:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0";
const res = await fetch(`https://api.westkite.com/v1/properties/${id}/site`, {
  headers: { Authorization: `Bearer ${process.env.WESTKITE_API_KEY}` },
});
const { data, missing } = await res.json();
```

```python
import os, requests

id = "property:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0"
res = requests.get(
    f"https://api.westkite.com/v1/properties/{id}/site",
    headers={"Authorization": f"Bearer {os.environ['WESTKITE_API_KEY']}"},
)
body = res.json()
```

## Response

```json 200
{
  "data": {
    "id": "property:3f2b9c1e-…",
    "address": "1840 Industrial Way",
    "coordinates": { "lat": 29.7604, "lng": -95.3698 },
    "screened_parcel": true,
    "hazards": {
      "answer": "Outside the 100-year floodplain",
      "tone": "good",
      "note": null,
      "findings": [{ "group": "Flood", "name": "FEMA flood zone", "value": "Zone X", "detail": null, "tone": "good", "sourceId": "fema-flood" }]
    },
    "environmental": { "answer": "…", "tone": "watch", "findings": [] },
    "incentives": { "answer": "…", "tone": "good", "findings": [] },
    "buildability": { "answer": "…", "tone": "good", "findings": [] },
    "zoning": null,
    "sources": [{ "id": "fema-flood", "label": "National Flood Hazard Layer", "publisher": "FEMA" }],
    "note": "A screen, not a Phase I: it reads federal and state public layers (state cleanup lists are not covered)."
  },
  "missing": [{ "field": "zoning", "reason": "not_published", "note": "No zoning, FAR or buildable area is published for this parcel." }],
  "billing": { "operation_id": "op_91c2…", "operation": "site_report", "charged_usd": 0.05, "balance_usd": 9.87 },
  "request_id": "req_91c2…"
}
```

Each topic has an `answer`, a `tone` (`good`, `neutral`, `watch` or `bad`) and its `findings`, each naming the source it came from.

| Topic | What it reads |
|---|---|
| `environmental` | Superfund, brownfields, leaking underground tanks, hazardous waste and chemical releases, within ASTM Phase I search distances, and air quality nonattainment areas (EPA Green Book), and transportation noise |
| `hazards` | FEMA flood zone, the National Risk Index, wildfire hazard, sea level rise, the nearest high or significant hazard dams within 5 mi, a FEMA map revision (LOMR) in effect at the site, map amendments (LOMA) on or beside it, and the USGS seismic design category (ASCE 7-22, site class D); also drought, hail reports and radar-estimated maximum hail size, and the county's flood insurance claims and disaster declarations (this product uses OpenFEMA data but is not endorsed by FEMA) |
| `incentives` | Opportunity Zones from 2018 and 2027, New Markets Tax Credit tracts, LIHTC qualified tracts and difficult development areas, HUBZones, state enterprise zones, IRA energy communities, the nearest foreign trade zone and zone sites within 3 mi (placed by street address, so the position is approximate) |
| `buildability` | Soils, wetlands, protected land, critical habitat, karst, radon zone and slope; rail lines, gas pipelines and the county's pipeline miles; airport noise contours where published; controlled airspace over the site and the FAA drone ceiling; and jurisdiction: whether the site is on tribal land (a reservation, trust land, Hawaiian Home Land or joint-use area), and the nearest military installation within 2 miles, flagging a base on Treasury's list for CFIUS review of foreign real estate purchases |
| `location` | What the area around the site is like: walkability, tree canopy, climate normals and snow days, solar resource, shale plays, water stress, undersea cable landings, electric tariffs, fiber reported in the area, modelled 5G coverage, the county's power outages and new business applications, and state DOT projects and planned transit where published |
| `zoning` | The published district, FAR and buildable area, where the county or city gives them |

Every row also has a map layer you can read on its own, by point or area, at [area layers](https://westkite.com/docs/api/layers.md).

`screened_parcel` is `true` when the screen measured the parcel outline, and `false` when it used the property's point.

## Missing and unknown

A source that didn't answer comes back in `missing` as `temporarily_unavailable`: its results are unknown, not clear. Ask again shortly. A screen that answers nothing at all costs nothing.

This is a screen, not a Phase I environmental site assessment. It reads federal and state public layers; state cleanup lists aren't covered.

## Errors

| Code | When |
|---|---|
| [`not_found`](https://westkite.com/docs/api/errors.md#not_found) | No published property has that ID. |
| [`insufficient_balance`](https://westkite.com/docs/api/errors.md#insufficient_balance) | Your balance can't cover $0.05. |
| [`max_cost_too_low`](https://westkite.com/docs/api/errors.md#max_cost_too_low) | You sent a `max_cost_usd` below $0.05. |
