policyengine-api

PolicyEngine's REST API provides programmatic access to tax and benefit calculations through Flask-based endpoints. You can query household calculations, policy reforms, and economy impacts by sending requests to endpoints that handle input validation, caching via Redis, and asynchronous job processing for long-running tasks across multiple country packages.

Yes. The API integrates into custom web services with built-in request validation, Redis caching for performance, and rate limiting. It dynamically loads country-specific packages (US, UK, etc.) and routes requests accordingly, enabling seamless data exchange while handling both synchronous and asynchronous calculations.

The API implements Redis caching to reduce redundant calculations and uses RQ for background job processing. This enables efficient handling of high-volume requests and long-running policy simulations while maintaining scalability across multi-country deployments.

Long-running tasks use asynchronous job handling through RQ, allowing the API to process complex economy impact analyses and policy reforms without blocking requests. Results are cached and retrievable, supporting scalable multi-country policy simulations.

The API provides comprehensive endpoints for household calculations, policy management, economy impacts, and metadata retrieval. Each endpoint follows standardized patterns with proper request validation and error handling, documented via OpenAPI specification.

No. The API dynamically loads and routes requests to specific country packages, abstracting country-specific configuration. You specify the country in your request, and the API handles package loading and parameter retrieval automatically.