# Establishments

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

Find the named businesses and operators at an address or in an area: bank branches, licensed premises, pharmacies, care facilities, child care, schools, nonprofits, industrial sites, fuel and charging stations, airports, wind turbines, solar farms and more. Each comes from a national or state public register, keeps its source, and carries the property it stands on when one matches. Rows cost $1 per 1,000, the same as any [find](https://westkite.com/docs/api/find.md).

```endpoint
GET /v1/find/establishments
POST /v1/find/establishments
```

Establishments are a type of [find](https://westkite.com/docs/api/find.md), so they take the same `where`, `in`, `near`, `lat` and `lng`, `radius_m`, `limit` and `cursor`. `limit` goes up to 100 rows a call; follow `next_cursor` for more.

## Kinds

Every row has one `kind`. Ask for one with `where=kind = bank_branch`, or several with `where=kind in bank_branch,credit_union`. With no `kind` clause you get every kind.

| Value | What it is |
|---|---|
| `bank_branch` | An office of an FDIC-insured bank (FDIC BankFind) |
| `credit_union` | A credit union office (NCUA) |
| `liquor_license` | A retail alcohol licence at a premises (state alcohol boards) |
| `snap_retailer` | A store authorized to take SNAP (USDA) |
| `pharmacy` | A pharmacy |
| `medical_practice` | A medical, dental or therapy practice location (NPPES, CMS) |
| `care_facility` | A nursing home, hospital, dialysis, home health, hospice or surgery centre (CMS) |
| `health_center` | A federally qualified health centre site (HRSA) |
| `child_care` | A licensed child-care centre or Head Start site |
| `school` | A college campus or private school (NCES) |
| `post_office` | A post office |
| `government_facility` | A government site: a federal prison or detention centre, courthouse, DMV office, VA benefits office, Vet Center or national cemetery |
| `nonprofit` | A tax-exempt organization's filing address (IRS) |
| `industrial_facility` | An EPA-regulated or greenhouse-gas reporting facility, with its parent company where reported (EPA ECHO, GHGRP) |
| `ev_charger` | A public electric-vehicle charging station (DOE AFDC) |
| `fuel_station` | An alternative-fuel station: CNG, LPG, E85, hydrogen and so on (DOE AFDC) |
| `airport` | An airport or heliport, with its owner where that is an organisation (FAA) |
| `port_terminal` | A port facility: dock, terminal or marina (USACE) |
| `refinery` | A petroleum refinery, with its operator and capacity (EIA) |
| `gas_storage` | An underground natural gas storage field (EIA) |
| `petroleum_terminal` | A bulk fuel terminal approved by the IRS (IRS) |
| `wind_turbine` | A utility-scale wind turbine, with its project, model and capacity (USGS USWTDB) |
| `solar_farm` | A large ground-mounted or rooftop solar facility of 1 MW or more, with its capacity (USGS USPVDB) |
| `stream_gauge` | A USGS stream gauge, with its drainage area |
| `wic_vendor` | A store authorized to take WIC (state health departments) |
| `casino` | A licensed casino (state gaming regulators) |
| `short_term_rental` | A short-term rental listing, with price, availability, reviews, licence number and estimated nights booked and revenue (Inside Airbnb) |
| `short_term_rental_market` | A neighbourhood's short-term rentals: listing count and median nightly price, nights booked and revenue by bedrooms (Inside Airbnb, derived) |
| `campground` | A federal campground or recreation site (Recreation.gov RIDB), or a licensed RV park or campground |
| `library` | A public library branch, with its building size (IMLS) |
| `mobile_home_park` | A mobile home or RV park, with its lot count where published |
| `oil_gas_well` | An oil or gas well: permits, status, operator and production where published (state regulators, USGS orphaned wells) |
| `water_well` | A groundwater well with its depth (USGS, state water agencies) |
| `water_tower` | A water tower or elevated tank (FAA obstacle file) |
| `cannabis_license` | A licensed cannabis dispensary, grower, processor or lab (state cannabis regulators) |
| `vehicle_dealer` | A licensed motor vehicle dealer (state motor vehicle agencies) |
| `contractor` | A licensed contractor business (state licensing boards) |
| `consumer_lender` | A licensed payday, consumer-finance or pawn lender, or a check casher (state financial regulators) |
| `lottery_retailer` | A state lottery retailer, with its sales where published |
| `lodging` | A hotel or other lodging business with a state hotel-tax permit |
| `billboard` | A permitted outdoor advertising sign, with its owner (state DOTs) |
| `water_right` | A surface or groundwater right at its point of diversion, with priority and amount (state water agencies) |
| `workplace` | An establishment inspected by OSHA, with its industry, headcount and inspection history |
| `layoff_notice` | A WARN Act layoff or closure notice at an employer's site, with the workers affected (state labor agencies) |
| `federal_contractor` | A federal contractor or SAM.gov-registered entity at its address, with obligations and NAICS (SAM.gov, USAspending) |
| `ppp_loan` | An SBA Paycheck Protection Program loan to a business or individual, at the borrower's published address (it may be a home and is not evidence of a tenant) |
| `visa_employer_worksite` | An employer's H-1B or PERM worksite, with case counts (DOL disclosure files). Street, job titles and wages only at the employer's own address or where one filing has two or more workers; other worksites are city and ZIP only |
| `motor_carrier` | A motor carrier's base, with power units and drivers (FMCSA census) |
| `drug_establishment` | An FDA-registered drug establishment (FDA) |
| `sales_tax_permit` | A sales-tax permit at an outlet location (state tax agencies) |
| `subsidized_housing` | A HUD-assisted multifamily property, public housing development or public housing building, with its units. Don't sum units across public_housing_development and public_housing_building: they count the same units |

## Filters

| Field | Type | Operators | Values | Notes |
|---|---|---|---|---|
| `kind` | enum | `=` `in` | `bank_branch`, `credit_union`, `liquor_license`, `snap_retailer`, `pharmacy`, `medical_practice`, `care_facility`, `health_center`, `child_care`, `school`, `post_office`, `government_facility`, `nonprofit`, `industrial_facility`, `ev_charger`, `fuel_station`, `airport`, `port_terminal`, `refinery`, `gas_storage`, `petroleum_terminal`, `wind_turbine`, `solar_farm`, `stream_gauge`, `wic_vendor`, `casino`, `short_term_rental`, `short_term_rental_market`, `campground`, `library`, `mobile_home_park`, `oil_gas_well`, `water_well`, `water_tower`, `cannabis_license`, `vehicle_dealer`, `contractor`, `consumer_lender`, `lottery_retailer`, `lodging`, `billboard`, `water_right`, `workplace`, `layoff_notice`, `federal_contractor`, `ppp_loan`, `visa_employer_worksite`, `motor_carrier`, `drug_establishment`, `sales_tax_permit`, `subsidized_housing` |  |
| `name` | string | `=` `~` |  | (business or operator name contains) or = |
| `category` | string | `=` |  | As published: main_office, on_premise, nursing_home |
| `status` | string | `=` |  | As published: open, active, pending |
| `opened_on` | date | `>=` `<=` `between` |  | YYYY-MM-DD |
| `property_id` | string | `=` |  | Establishments matched to this property |
| `linked` | boolean | `=` |  | = true (matched to one property) or = false |

Search a place with `in` (a county or city by name, a ZIP code, or a New York City neighborhood), around a point with `near` or `lat` and `lng` plus `radius_m`, or at one property with `where=property_id = property:…`. With none of these, the search runs nationwide. A place the search can't apply is refused with `invalid_request`, never widened to the whole country, and `scope` in the answer says what was searched.

## Coverage

Registers are published state by state or nationally, and not every state publishes every kind. So each answer has `coverage`: one row for each kind you asked about and each state in scope, with `status`:

| Status | Means |
|---|---|
| `covered` | A source for this kind is loaded for this state. |
| `partial` | A source is loaded, but it doesn't list everything of this kind in this state, or some of its records have no county, so a county or city search can miss them. `note` says what's missing. No rows doesn't mean there are none. |
| `not_covered` | No source is loaded for this kind in this state. No rows doesn't mean there are none. |

A nationwide search lists only the kinds and states that aren't fully covered, and a kind with no source anywhere once, as state `US`. When you tell someone what's at an address, say a kind is unavailable where it's `not_covered`, never that there isn't one.

## Request

```curl
curl --get "https://api.westkite.com/v1/find/establishments" \
  -H "Authorization: Bearer $WESTKITE_API_KEY" \
  --data-urlencode "in=Travis County, TX" \
  --data-urlencode "where=kind = bank_branch" \
  --data-urlencode "limit=2"
```

```typescript
const params = new URLSearchParams({ in: "Travis County, TX", where: "kind = bank_branch", limit: "2" });
const res = await fetch(`https://api.westkite.com/v1/find/establishments?${params}`, {
  headers: { Authorization: `Bearer ${process.env.WESTKITE_API_KEY}` },
});
const { data } = await res.json();
```

```python
import os, requests

res = requests.get(
    "https://api.westkite.com/v1/find/establishments",
    params={"in": "Travis County, TX", "where": "kind = bank_branch", "limit": 2},
    headers={"Authorization": f"Bearer {os.environ['WESTKITE_API_KEY']}"},
)
data = res.json()["data"]
```

## Response

An abridged answer. `details` holds the publisher's own facts for the kind, so its keys differ from kind to kind.

```json 200
{
  "data": {
    "type": "establishments",
    "returned": 2,
    "by_kind": { "bank_branch": 2 },
    "establishments": [
      {
        "id": "establishment:19edccee0b025fcdd3f11879b92d4d04",
        "kind": "bank_branch",
        "category": "full_service_brick_and_mortar",
        "name": "American Bank of Commerce",
        "operator": "American Bank of Commerce",
        "identifier": "245874",
        "status": "open",
        "opened_on": "1996-01-08",
        "address": "610 W 5th St",
        "city": "Austin",
        "state": "TX",
        "county_fips": "48453",
        "postal_code": "78701",
        "coordinates": [-97.749439, 30.269196],
        "property_id": "property:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0",
        "link": { "method": "address", "candidates": 1 },
        "details": { "branch_name": "WEST FIFTH STREET BRANCH", "main_office": false, "fdic_certificate": "18609" },
        "first_seen": "2026-11-19",
        "last_seen": "2026-11-19",
        "source": {
          "id": "US-FDIC-LOCATIONS",
          "name": "FDIC BankFind branch locations: every open branch of an insured bank",
          "publisher": "Federal Deposit Insurance Corporation",
          "url": "https://banks.data.fdic.gov/bankfind-suite/",
          "as_of": "2026-11-19",
          "licence": "US federal government work (17 U.S.C. 105), public domain"
        }
      }
    ],
    "coverage": [{ "kind": "bank_branch", "state": "TX", "status": "covered" }],
    "next_cursor": "est1.2",
    "has_more": true
  },
  "missing": [],
  "billing": { "operation_id": "op_…", "operation": "find", "charged_usd": 0.002, "balance_usd": 9.99 },
  "request_id": "req_…"
}
```

Every field is in the [API reference](https://westkite.com/docs/api/reference.md#establishment-kind) and the [OpenAPI document](https://api.westkite.com/v1/openapi.json) under `Establishment`.

## From an establishment to its property

`property_id` is set when exactly one property matched the published address or point. `link.method` says how it matched: `address` or `point_in_parcel`. `link.candidates` counts the properties that matched: above 1 means several share the address, such as condo units, and `property_id` is left empty.

Read the property itself with [GET /v1/properties/{id}](https://westkite.com/docs/api/properties.md):

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

And the other way, everything a register places at one property:

```curl
curl --get "https://api.westkite.com/v1/find/establishments" \
  -H "Authorization: Bearer $WESTKITE_API_KEY" \
  --data-urlencode "where=property_id = property:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0"
```

A licence or registration shows an operator at the premises. It isn't proof of a lease.

## More examples

Pharmacies with a name in Cook County, Illinois:

```curl
curl --get "https://api.westkite.com/v1/find/establishments" \
  -H "Authorization: Bearer $WESTKITE_API_KEY" \
  --data-urlencode "in=Cook County, IL" \
  --data-urlencode "where=kind = pharmacy" \
  --data-urlencode "where=name ~ Walgreens"
```

Bank branches within 500 m of a point, nearest first:

```curl
curl --get "https://api.westkite.com/v1/find/establishments" \
  -H "Authorization: Bearer $WESTKITE_API_KEY" \
  --data-urlencode "lat=30.291981" \
  --data-urlencode "lng=-97.820569" \
  --data-urlencode "radius_m=500" \
  --data-urlencode "where=kind = bank_branch"
```

Care facilities in a county that aren't matched to a property yet:

```curl
curl --get "https://api.westkite.com/v1/find/establishments" \
  -H "Authorization: Bearer $WESTKITE_API_KEY" \
  --data-urlencode "in=Travis County, TX" \
  --data-urlencode "where=kind = care_facility" \
  --data-urlencode "where=linked = false"
```

Wind turbines in a county, with each turbine's project, model and capacity in `details` (USGS wind turbine database). Solar farms (`solar_farm`) work the same way, one row per facility at its centre:

```curl
curl --get "https://api.westkite.com/v1/find/establishments" \
  -H "Authorization: Bearer $WESTKITE_API_KEY" \
  --data-urlencode "in=Nolan County, TX" \
  --data-urlencode "where=kind = wind_turbine"
```

## Errors

| Code | When |
|---|---|
| [`invalid_request`](https://westkite.com/docs/api/errors.md#invalid_request) | An unknown kind or field, or an operator the field doesn't take. The message lists what's allowed. Also `count`, which applies to properties only. |
| [`insufficient_balance`](https://westkite.com/docs/api/errors.md#insufficient_balance) | Your balance can't cover the page. |
| [`rate_limited`](https://westkite.com/docs/api/errors.md#rate_limited) | Too many requests this minute. |
