US Municipal Capital Projects API

City and county capital budgets and capital improvement programmes in one schema: projects with their department, category, status and location where the source gives them, and every published amount by fiscal year, amount type and funding source. Served by the Olympus Go gateway.

As published. Each government publishes its capital plan in its own way: an open-data table of budget lines, a project tracker, or a PDF budget document. Names, amounts, statuses and fiscal years are as each source publishes them, mapped onto one schema. Nothing is inflated, reconciled between a government's datasets, or estimated, and no amount is inferred. Every response repeats this in meta.notices (as_published).

Amount types. budget (budgeted, appropriated, adopted or programmed for the fiscal year or years given), cumulative_budget (budget or appropriation to date, over the project's life), actual (spent in the fiscal year), cumulative_actual (spent to date), committed (encumbered or committed), authorization (borrowing or loan authorization) and total_cost (a stated total project cost). amount_label names the column or printed heading each amount comes from. Amounts of different types must not be added together.

Fiscal years. Each government's own fiscal year, named by the year it ends (FY 2027 = the year ending in 2027 at most governments). An amount for several years has fiscal_year_from < fiscal_year_to; an amount to date has neither. fiscal_year_derived is true when the year is computed rather than printed in the row (NYC's year2_amt is yr1_fy + 1; Fremont's printed 2023/24 is read as FY 2024; a PDF's fiscal year comes from its title), and fiscal_year_label keeps what was printed.

Provenance. Every amount carries value_provenance: for an open-data source the dataset, its version (rows_updated_at), the SHA-256 of the retained response, the row id and the field; for a PDF the document URL and SHA-256, the page, the bounding box (PDF points from the top left), the printed text, how it was read and the extraction spec. Projects carry field_provenance for their own fields. PDF rows are published only when every check passed for the document and the row was read cleanly; rows held for review are counted in coverage and never served. derived marks computed values: the normalised status, a derived fiscal year, a scaled amount (amount_derived), and every total this API computes (totals_derived).

People. Columns that name people (project managers, their phone numbers and e-mail addresses, architects and contractors who may be individuals) are never read. Governments are identified by their Census GEOID: a place (OLY-US-CENSUS-PLACE, 7 digits) for a city or town, a county (OLY-US-CENSUS-COUNTY, 5 digits) for a county, checked against the Census Gazetteer at every load.

Coverage. Only the sources GET /v1/municipal-capital-projects/coverage lists as published. Each source's licence or terms are listed as the publisher states them, with commercial_reuse (permitted, attribution or unstated) and any attribution the publisher asks for.

Pagination. GET /projects pages with a cursor (meta.pagination.next_cursor; pass it back unchanged with the same filters). A cursor is tied to the publication it was issued under.

Authenticate with an API key in X-API-Key or Authorization: Bearer. The organization's plan must include municipal-capital-projects. Every response carries X-Request-Id. Errors share the Error body.