---
title: "Look up one property record by address, lat+lng, or parcel_id (2 credits)"
method: GET
path: "/v1/property"
---

# Look up one property record by address, lat+lng, or parcel_id (2 credits)

`GET /v1/property`

## Request

- Base URL: `https://swathapi.com`
- URL: `https://swathapi.com/v1/property`
- Auth: HTTP bearer

Provide exactly one of: address, lat AND lng, or parcel_id. Costs 2 credits. On the free plan only cached records are returned (a cache miss is a 404 explaining that live vendor coverage requires a paid plan).

## Query parameters

- `address` string
- `lat` number
- `lng` number
- `parcel_id` string

## Response `200`

Property record

- Property
  - `id` string: Property id (prop_...)
  - `parcel_id` string, nullable
  - `address` string
  - `city` string, nullable
  - `state` string, nullable
  - `zip` string, nullable
  - `lat` number, nullable
  - `lng` number, nullable
  - `year_built` integer, nullable
  - `sqft` number, nullable
  - `roof_material` string, nullable: Reserved — not populated yet, always null.
  - `last_roof_permit` string, nullable
  - `roof_age_est` number, nullable
  - `roof_age_source` string, nullable
  - `owner_occupied` boolean, nullable
  - `assessed_value` number, nullable
  - `vendor` string: Data source label
  - `fetched_at` string, date-time
  - `cache` 'hit' | 'miss': Whether this record came from cache or a live vendor fetch

## Other responses

- `400`: Missing/invalid lookup parameters
- `401`: Missing, invalid, or revoked API key. Fix: pass Authorization: Bearer sk_... (get a key at /v1/signup).
- `402`: Monthly credit limit reached (code credits_exhausted). Fix: upgrade via POST /v1/billing/checkout or wait for the monthly reset.
- `404`: No property record found (on free plan: no cached record)
- `429`: Per-minute rate limit for the plan exceeded (code rate_limited). Retry after a short wait.

---

[API](https://skmtc.dev/swathapi/apis/swath-api.md) · [All operations](https://skmtc.dev/swathapi/apis/swath-api/llms.txt) · [OpenAPI document](https://skmtc.dev/swathapi/apis/swath-api/revisions/7dbea40372ef?raw)