API Documentation

Programmatic access to UnGovr data for researchers, journalists, and civic technologists.

Testing – The API is available to approved partners. We're accepting applications from researchers, journalists, civic technologists, and government agencies.

What's Available

The UnGovr API provides RESTful access to government entity data, geographic boundaries, and service request routing. All responses are JSON unless otherwise noted.

API Endpoints

Core resources available today

Entity Search

Search and look up government entities by name, location, type, or country. Returns contact information, jurisdiction details, and hierarchy.

Geographic Boundaries

Retrieve GeoJSON boundary data for entities with mapped jurisdictions. Supports point-in-polygon queries to find entities serving a location.

Service Request Routing

Submit non-emergency service requests and let UnGovr Request route them to the correct jurisdiction and agency based on location and issue type.

Entity Registry

Browse the full registry of 320,000+ government entities across 200+ countries, with filtering by type, country, and hierarchy level.

Machine Payments (MPP)

Both the REST API and MCP server support the Machine Payments Protocol (IETF draft). AI agents that exceed free-tier limits can pay per request using a pre-loaded wallet funded via Stripe.

  • REST API (data.ungovr.org) — standard HTTP 402 challenges with WWW-Authenticate: Payment
  • MCP server (mcp.ungovr.org) — JSON-RPC error code -32042 with credentials in _meta
  • Pricing — from $0.001 per entity lookup to $0.05 for image-based service requests
  • Minimum top-up — $5.00 via Stripe

Getting Started

To request access, tell us about your use case and we'll get you set up with an API key.

Request API Access