Atlas Circular

Tracking sustainability across the globe

▾

Build on the data

The SignalScout 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.

GET
/compliance/fee-schedule

Producer-fee estimates with citations grounded in enacted text.

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).

GET
/evaluate/material-map

The material-position map: each material’s value / dispersion / channel axes + intervention regime.

POST
/evaluate/billPro

Score a measure’s strength — positions its material into a regime and scores its mechanisms against the strong baseline, with a corpus cross-check.

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.