---
title: "Match County Primitives"
method: POST
path: "/api/v1/map/county/{county_fips}/primitives/match"
tags: ["map"]
---

# Match County Primitives

`POST /api/v1/map/county/{county_fips}/primitives/match`

Resolve a prompt to the primitive values it selects, across every table.

Returns filters, not features. The client already holds the county's tiles,
so a value set is all it needs to repaint — which is why this can be a
single small request on the interactive path instead of a re-render.

Unmatched prompts return no filters rather than a best guess: a preview that
lights something up for "asdfghjkl" is worse than one that stays dark.

## Path parameters

- `county_fips` string, required

## Query parameters

- `token` string, nullable — Firebase ID token for MVT authentication
- `project_id` string, uuid, nullable

## Request body

- PrimitiveMatchRequest — The prompt to resolve. POSTed as a body rather than a query string so the user's chat text stays out of access logs, proxy logs, and URL-keyed span attributes.
  - `q` string, required

## Response `200`

Successful Response

- PrimitiveMatchResponse — Resolved semantic filters for a prompt, best-scoring table first.
  - `filters` PrimitiveFilter[], required
    - `layer` string, required
    - `property` string, required
    - `table` string, required
    - `values` string[], required
    - `count` integer, required
    - `score` number, required
  - `regions` PrimitiveRegion[]
    - `kind` string, required
    - `label` string, required
    - `geometry` object, required
  - `term_count` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-28** `0c94a4b5a00e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/maia-analytics/apis/maia-api/changes/api/v1/map/county/:county_fips/primitives/match/post.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-service-production.skmtc.workers.dev/v1/apis/maia-analytics/maia-api/revisions/4c1b045ef2af/schema)