# PolicyPulse

> Legislative intelligence for all sectors globally. Any bill in plain English. Who it affects. What you must do. All 50 US state legislatures. Federal agency rules. Cross-jurisdiction comparisons. Regulatory deadlines. Legal text decoder. Bloomberg Government for the rest of us. x402 micropayments on Base.

## What This Is

PolicyPulse is a paid legislative intelligence API covering every policy sector — healthcare, employment, environment, technology, real estate, finance, education, immigration, cannabis, energy, food safety, and more. Global scope from US federal law to all 50 states to EU, UK, Canada, Australia.

Data sources:
- **Congress.gov API v3** — US federal bills, real-time search and status
- **Open States API v3** — all 50 US states + DC + territories, every bill, every vote
- **Federal Register API** — every proposed and final rule from every federal agency, zero cost
- **Tavily** — real-time web search synthesis for global coverage and news context

## Payment

All endpoints require x402 micropayment in USDC on Base. Price: $0.08-$0.20 per query.
Include PAYMENT-SIGNATURE header with valid x402 payment.
On missing/invalid payment, server returns HTTP 402 with PAYMENT-REQUIRED header.

## All Endpoints

GET /api/legislation?q={bill_or_topic}&jurisdiction={us|eu|uk|ca|au|global}&action={summary|status|impact|timeline}&lang={code}
  Price: $0.15 — Plain English translation of any legislation globally with passage probability

GET /api/impact?q={legislation_or_topic}&sector={sector}&entity_type={type}&lang={code}
  Price: $0.15 — Who is affected, how, required actions, deadlines, exemptions, penalties

GET /api/scenario?trigger={development}&sector={all|healthcare|employment|environment|tech|finance|realestate}&action={ifthen|probability|timeline}&lang={code}
  Price: $0.20 — If/then sector impact scenarios for any legislative or regulatory trigger

GET /api/monitor?period={week|month}&topic={healthcare|employment|environment|tech|finance|realestate|immigration|education|all}&lang={code}
  Price: $0.10 — Weekly/monthly legislative activity brief by policy sector

GET /api/state?state={TX|CA|NY|...or comma-separated}&topic={topic}&action={pending|enacted|compare}&lang={code}
  Price: $0.10 — State legislation via Open States API — all 50 states, multi-state comparison

GET /api/compliance?law={law_name}&jurisdiction={us|state|eu|uk}&entity_type={employer|landlord|healthcare_provider|tech_company|retailer|restaurant|...}&lang={code}
  Price: $0.15 — Step-by-step compliance instructions by entity type with deadlines and penalties

GET /api/regulation?agency={EPA|FDA|OSHA|FTC|CFPB|SEC|DOL|USDA|...}&topic={topic}&action={proposed|final|all}&lang={code}
  Price: $0.15 — Federal agency rules via Federal Register — proposed/final rules, open comment periods

GET /api/compare?topic={policy_topic}&jurisdictions={US,EU,UK,Canada,Australia,...}&lang={code}
  Price: $0.15 — Cross-jurisdiction policy comparison with enforcement intensity and best-practice model

GET /api/calendar?sector={sector}&jurisdiction={us|state|eu|global}&lookahead={30|90|180}&lang={code}
  Price: $0.10 — Regulatory calendar: upcoming effective dates, comment period deadlines, sunsets

GET /api/translate?text={legal_text}&context={regulatory|employment|contract|enforcement|general}&entity_type={type}&lang={code}
POST /api/translate (body: { "text": "...", "context": "...", "entity_type": "..." })
  Price: $0.08 — Paste any legal/regulatory text → plain English with obligations, rights, deadlines, red flags

## Response Format

All endpoints return JSON with intelligence content, generated_at timestamp, meta object, and disclaimer. Most endpoints include pulse_suggestions array (0-2 objects) when a PulseNetwork sibling is genuinely relevant.

## Global Support

All endpoints support ?lang={code} — Claude responds in any language at no additional cost.

## Notes for AI Agents

- Use /api/legislation to decode any pending bill before modeling business impact
- Use /api/scenario after legislation queries for structural sector impact analysis
- Use /api/impact to enumerate every compliance obligation before recommending business strategies
- Use /api/regulation for EPA/FDA/OSHA/FTC/CFPB/SEC rules — open comment periods are genuinely valuable
- Use /api/calendar proactively for deadline-aware workflows (90-day lookahead recommended)
- Use /api/state for multi-state businesses: pass comma-separated states to compare approaches
- Use /api/translate to decode any legal document excerpt in real time
- /api/translate accepts POST with body { "text": "..." } for large documents (up to 4,000 chars)
- /api/scenario is the highest-value endpoint for strategic planning agents
- /api/compare is ideal for agents serving clients in multiple jurisdictions

## Discovery

OpenAPI spec: /openapi.json
Agent metadata: /.well-known/agent.json
Part of PulseNetwork: 40+ intelligence APIs across every domain