Atlas Circular
▾

Build on the data

The Atlas Circular API — circular-economy legislation as structured, current data

Every bill, status, deadline, fee, and AI classification behind Atlas Circular is available over a plain REST/JSON API. Read endpoints are open and rate-limited — no key needed to start. For production volume, commercial terms, bulk exports, or webhooks, .

Base URL

https://signalscout-api-36712717703.us-central1.run.app

Responses are JSON. All endpoints are versionless today; breaking changes will be announced to access-holders before they ship.

Quickstart

The 25 most recent enacted EPR laws, newest first:

curl "https://signalscout-api-36712717703.us-central1.run.app/bills?ce_relevant=true&status=enacted&limit=25"

One bill in full, with extracted compliance detail:

curl "https://signalscout-api-36712717703.us-central1.run.app/bills/12345"

Authentication & limits

  • Read endpoints need no auth — they are rate-limited per IP. Fine for prototyping, dashboards, and research.
  • Analysis endpoints (POST /evaluate/bill, POST /research/ask) run large-model inference and are Pro-gated — pass a Bearer token: Authorization: Bearer <token>.
  • Production use — higher rate limits, a stable SLA, bulk/webhook delivery, and commercial licensing come with an API plan. Usage-based pricing.

Endpoints

Bills

The core dataset — circular-economy bills across all 50 US states, the EU, and 25+ national jurisdictions, kept current with extracted compliance detail.

GET
/bills

List / filter bills. Params: ce_relevant, state, region, regions (CSV), status, instrument_type, material_category, policy_stance, urgency, limit, offset.

GET
/bills/{id}

One bill in full, including the extracted compliance_details (the 8 dimension envelopes).

GET
/bills/search?q=

Full-text search over persisted bill text; returns highlighted snippets.

GET
/bills/outcomes

Documented real-world outcomes attributable to enacted laws (each source-cited).

GET
/bills/deadlines/upcoming

Upcoming compliance deadlines extracted from enacted laws.

Analytics

Pre-computed aggregates — the same series behind the Insights dashboards, ready to chart.

GET
/bills/timeline

Bill counts per year by status (introduced → enacted). Params: instrument_type, material_category, regions.

GET
/bills/laws-in-force

Cumulative enacted laws in force over time, per region.

GET
/bills/stance-momentum

Per-year counts by policy stance (advances / weakens / neutral).

GET
/bills/instrument-material-matrix

Coverage heatmap: bill counts per (policy instrument × material).

GET
/bills/collection-target-basis

How collection targets are measured (weight vs value-recovered vs …), per region.

GET
/insights/state-gap

Each US state’s CE passage rate vs its all-bills baseline.

GET
/insights/champions

Legislators leading CE bills, ranked; drill into their bills.

Compliance & regulatory

The obligations behind the laws — fees, pathways, federal action, and litigation. Fee data comes in two layers: the amounts a law itself STATES (fee-amounts, cited to the enacting text) and curated per-material rate tables set by agency/PRO rulemaking (fee-schedule).

GET
/compliance/fee-amounts

Producer fees a law states — per-tonne / per-unit / flat / %-revenue, each cited to a verbatim excerpt. US-only free; the full 40+ jurisdictions need an API plan.

GET
/compliance/fee-amounts/summary

Open aggregate: fee coverage counts by jurisdiction, kind, basis, and currency.

GET
/compliance/eco-modulation

Eco-modulation criteria (design attributes that raise/lower fees) per law, cited. US-only free; full set with an API plan.

GET
/compliance/fee-schedule

Curated per-material producer-fee rate tables + eco-modulation math (CA SB 54, UK pEPR, Japan) — the runnable rates set by agency/PRO rulemaking, not the statute.

GET
/compliance/pathways

The primary next-action per enacted law (join this PRO / file this plan).

GET
/federal-actions

Tracked federal regulatory actions (US).

GET
/litigation-cases

Circular-economy litigation cases; drill into a case for events.

Analysis (AI)

Structured judgment over the corpus. These accept a request body and are Pro-gated (Bearer token).

POST
/research/askPro

Ask a natural-language question over the corpus; returns a cited answer + optional SQL-backed chart.

Example response

GET /bills/{id} returns the bill plus its extracted compliance envelopes:

{
  "id": 12345,
  "region": "US",
  "state": "CA",
  "bill_number": "SB 54",
  "title": "Plastic Pollution Producer Responsibility Act",
  "status": "enacted",
  "instrument_type": "epr",
  "material_categories": ["plastic packaging"],
  "compliance_details": {
    "collection_targets": {
      "status": "present",
      "targets": [{ "material": "packaging", "percent": 65, "by_year": "2032", "basis": "weight" }]
    },
    "pro_structure": { "status": "present", "model": "single_pro" },
    "eco_modulation": { "status": "present", "criteria": ["recyclability", "recycled_content"] }
    // …fee_amounts, penalties, recycled_content, bans_restrictions, labeling
  }
}

Ready for production?

Tell us your use case and volume — we’ll set you up with an API plan, higher limits, and commercial terms. See pricing.