---
title: "Get Address Feature Geometry"
method: GET
path: "/api/v1/project/address/feature-geometry"
tags: ["project"]
---

# Get Address Feature Geometry

`GET /api/v1/project/address/feature-geometry`

Drawable geometry + bbox for one resolved candidate, pre-project.

``county_fips`` is the candidate's county; it bounds the read so a commons
workspace plans against that county's partition alone.

404 covers a malformed/unknown ``feature_id``, a row with null geometry, and a
county the workspace may not read — either way there is nothing to draw. Read
failures map to 503, mirroring ``/address/resolve``.

## Query parameters

- `source_table` 'parcel' | 'building' | 'place' | 'address' | 'school', required — The table a resolved feature lives in — what a caller pulls its data from, and the feature's kind. A text match in the ``address``, ``place`` or ``school`` table resolves (point-in-feature) to a ``parcel``/``building``; a ``parcel`` attribute match resolves to the parcel itself.
- `feature_id` string, required
- `county_fips` string, required

## Response `200`

Successful Response

- AddressFeatureGeometryResponse — Drawable shape for one candidate: GeoJSON ``geometry`` plus its envelope ``bbox`` ``(min_lng, min_lat, max_lng, max_lat)`` so the confirm card can draw the boundary and frame the camera in one request.
  - `geometry` object, required
  - `bbox` unknown[], required
    - unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-25** `bb508e935174` — 3 breaking, 1 info
  - the `query` request parameter `county_fips` became required
  - `query` request parameter `county_fips` list-of-types was narrowed by removing types `null`
  - added the pattern `^\d{5}$` to the `query` request parameter `county_fips`
  - for the `query` request parameter `county_fips`, the type was generalized from no type to `string`
- **2026-09-24** `8beaac28e195` — 1 info
  - added the new optional `query` request parameter `county_fips`

[Change history](https://skmtc.dev/maia-analytics/apis/maia-api/changes/api/v1/project/address/feature-geometry/get.md)

---

[API](https://skmtc.dev/maia-analytics/apis/maia-api.md) · [All operations](https://skmtc.dev/maia-analytics/apis/maia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maia-analytics/apis/maia-api/revisions/bb508e935174?raw)