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

Law Endpoints

Government transparency laws as data: public records laws with deadlines, fees, exemptions and appeal processes, plus a cross-domain index spanning records, meetings, fiscal transparency, accessibility, and oversight statutes.

Endpoint	Description	Auth
`/laws/records/index.json`	Full records-law corpus, compact index	Open
`/laws/records/{jurisdiction}.json`	One records law in full ('us--ca'; national laws use the country code, US federal is 'us')	Open
`/laws/transparency/index.json`	Transparency laws across five domains, one uniform index	Open

Example: California's public records law

# Deadlines, fees, exemptions and appeals under the CPRA
curl https://data.ungovr.org/v1/laws/records/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

AI and Crawling Law

Verdict-level summaries of how each jurisdiction's law treats automated access: crawl policy, a per-scenario access matrix, and fields such as robots.txt legal weight and text-and-data-mining opt-out status. Every response carries as_of_date, confidence, and stale flags. These files are a research summary, not legal advice and not authorization to access any system.

Endpoint	Description	Auth
`GET /v1/ai-laws/index.json`	Covered jurisdictions with freshness metadata	API Key
`GET /v1/ai-laws/{jurisdiction}.json`	One jurisdiction; slugs are lowercase, for example `us`, `us/ca`, `eu`	API Key
`GET /v1/ai-laws/vocab.json`	Definitions for every verdict and field value	API Key

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.