Skip to main content
GET
Search geo signals within a state
Searches geo-scoped signals across a state, with filters like geo_type, signal_keys, and decision/score thresholds. Use this when you want ranked or filtered geo-level opportunities, not just one fixed geo_id. For narrative examples and interpretation guidance, see Signals & Methodology.

Required input

  • None (defaults to state=WA if omitted)

Optional input

  • state (2-letter code)
  • signal_keys (CSV list)
  • geo_type (jurisdiction, city, zip, county, state)
  • decision (for example positive)
  • min_score (0..1)
  • limit (1..100)
  • cursor (opaque pagination token)

Behavior notes

  • If signal_keys is provided, it is applied as a hard filter.
  • If signal_keys is omitted, results are ranked across all active geo signals by score.
  • Pagination order is score DESC, signal_key ASC, geo_id ASC.

Example request

Response shape

  • state
  • count
  • signals[] with geo_id, geo_type, display_name, signal_key, value, score, confidence, decision, reasons, computed_at
  • next_cursor

Authorizations

X-API-Key
string
header
required

Query Parameters

state
string
default:WA
Pattern: ^[A-Za-z]{2}$
signal_keys
string

Optional CSV list of signal keys.

geo_type
enum<string>
Available options:
property,
jurisdiction,
city,
zip,
county,
state
decision
string
Example:

"positive"

min_score
number
Required range: 0 <= x <= 1
Example:

0.5

limit
integer
default:25
Required range: 1 <= x <= 100
cursor
string

Opaque cursor from previous page.

Response

Signal rows matching filters.

state
string
required
count
integer
required
Required range: x >= 0
signals
object[]
required
next_cursor
string | null
required