% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/search.R
\name{cog_gov_search}
\alias{cog_gov_search}
\title{Search for governments by name, state, and/or type}
\usage{
cog_gov_search(pattern = NULL, state = NULL, type = NULL)
}
\arguments{
\item{pattern}{Character regex matched case-insensitively against
`gov_name`. `NULL` (default) means no name filter.}

\item{state}{Either a 2-letter USPS abbreviation (e.g. `"FL"`), a FIPS
integer (e.g. `12`), or `NULL`.}

\item{type}{Government type: an integer in `0:3` or one of `"state"`,
`"county"`, `"city"`, `"township"`. Passing `4`, `5`,
`"special_district"`, or `"school_district"` emits an explanatory
message and returns an empty tibble (v0.1 corpus excludes those types).}
}
\value{
Tibble from `canonical_fips_xwalk` sorted by `population_acs`
  descending (`NULL`s last).
}
\description{
Returns rows from `canonical_fips_xwalk` matching the supplied filters.
Intended as the entry point users call to resolve a human-readable place
name into one or more `canonical_govid` values before calling
[cog_spending()] / [cog_revenue()] / etc.
}