PolicyEngine API v2
A distributed system for running tax-benefit microsimulations with persistence and async processing.
Quick start
Get up and running with the API in minutes. Complete walkthrough from setup to your first simulation.
Economic impact
Calculate distributional impacts, decile analysis, and program statistics for policy reforms.
Architecture
Understand the system design: API server, worker, database, and how they work together.
API reference
Interactive documentation for all endpoints with live testing capabilities.
Features
Async processing
Simulations run asynchronously via a worker queue. Poll for status or use webhooks.
Deterministic caching
Same inputs produce the same simulation ID. Results are cached and reused automatically.
UK and US models
Full support for PolicyEngine UK and US tax-benefit systems with comprehensive datasets.
Policy reforms
Define custom parameter changes and compare reform scenarios against baselines.
Tip: Use the base URL input in the header to switch between local and production environments. The default is https://v2.api.policyengine.org.