API Reference

REST endpoints for government entities, boundaries, and grand jury reports

https://data.ungovr.org/v1

Entity Endpoints

Browse and search government entities across 200+ countries.

Endpoint	Description	Auth
`/entities/index.json`	List all countries with entity counts	Open
`/entities/{cc}.json`	List first-tier entities for a country (e.g., `us`)	Open
`/entities/{cc}/{state}.json`	List entities within a state or province	Open
`/entities/detail/{id}.json`	Full detail for a single entity	Open
`/entities/children/{id}.json`	List child entities of a parent	Open
`/entities/boundaries/{id}.geojson`	GeoJSON boundary for an entity	Open

Example: List California entities

# List all entities in California
curl https://data.ungovr.org/v1/entities/us/ca.json

CGJ Endpoints

Access California Civil Grand Jury reports, findings, and recommendations.

Endpoint	Description	Auth
`/cgj/index.json`	CGJ collection summary and statistics	Open
`/cgj/counties.json`	List all 58 counties with report counts	Open
`/cgj/counties/{code}.json`	Reports for a specific county (e.g., `ventura`)	Open
`/cgj/reports/{id}.json`	Full report detail with findings & recommendations	API Key

Example: Ventura County reports

# List reports for Ventura County
curl https://data.ungovr.org/v1/cgj/counties/ventura.json

# Get full report detail (requires API key)
curl -H "X-API-Key: YOUR_API_KEY" \
  https://data.ungovr.org/v1/cgj/reports/12345.json

Metadata

Schema definitions, versioning, and update timestamps.

Endpoint	Description	Auth
`/meta/countries.json`	Country code registry with names and coverage status	Open
`/meta/schema.json`	JSON Schema definitions for all response types	Open
`/meta/openapi.yaml`	OpenAPI 3.1 specification	Open
`/meta/last-updated.json`	Timestamp of the most recent data refresh	Open

Bulk Downloads

Download complete datasets as JSON files for offline analysis, research, or integration into your own systems. All files are available at the same base URL.

Entity Data

Government entity listings by country and state. Each file contains entity names, types, parent relationships, and website URLs.

File	Description
`entities/index.json`	Country index with entity counts
`entities/us.json`	United States — states and federal entities
`entities/us/ca.json`	California — counties, cities, special districts
`entities/ie.json`	Ireland — local authorities, counties
`entities/uk.json`	United Kingdom — councils, devolved bodies

Replace the country code in the URL to download data for any supported country. Use index.json to see all available country codes.

CGJ Reports

File	Description
`cgj/index.json`	Collection summary and statistics
`cgj/counties.json`	All 58 counties with report counts
`cgj/counties/ventura.json`	Ventura County reports
`cgj/counties/los-angeles.json`	Los Angeles County reports

Schema & Metadata

File	Description
`meta/countries.json`	Country code registry with names and coverage
`meta/schema.json`	JSON Schema definitions for all response types
`meta/openapi.yaml`	OpenAPI 3.1 specification
`meta/last-updated.json`	Timestamp of the most recent data refresh

Rate Limits

Resource	Free Tier
Entity data	100/day per IP
CGJ indices & county listings	Unlimited
CGJ report detail	50/day per key

Machine Payments (MPP)

When free-tier limits are exceeded, the API returns HTTP 402 with a Machine Payments Protocol challenge. AI agents and programmatic clients can pay per request from a pre-loaded wallet funded via Stripe.

Resource	Price
Entity data	$0.001
CGJ report detail	$0.01

Minimum wallet top-up is $5.00. Payments are processed via WWW-Authenticate: Payment / Authorization: Payment headers. See the MCP page for the equivalent JSON-RPC flow.