Build on the data

Base URL

https://api.atlascircular.com

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://api.atlascircular.com/bills?ce_relevant=true&status=enacted&limit=25"

One bill in full — Oregon’s Recycling Modernization Act, with its extracted compliance detail:

curl "https://api.atlascircular.com/bills/72452"

Note: list results omit compliance_details by design — the extraction is per-bill, and shipping it on every row of a bulk list would make the corpus-wide dataset a single call. Fetch it from /bills/{id}, which is free and needs no key. If the field looks missing, you’re reading a list response.

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

Example response

GET /bills/72452 returns the bill plus its extracted compliance envelopes — abridged here, but every field below is verbatim from the live response:

{
  "id": 72452,
  "region": "US",
  "state": "OR",
  "bill_number": "SB-582",
  "title": "Relating to modernizing Oregon's recycling system.",
  "status": "enacted",
  "instrument_type": "epr",
  "compliance_details": {
    "extraction_version": 5,
    "collection_targets": {
      "status": "present",
      "targets": [
        { "material": "Plastic", "percent": 25, "by_year": "2028", "basis": "material_specific" },
        { "material": "Plastic", "percent": 50, "by_year": "2040", "basis": "material_specific" },
        { "material": "Plastic", "percent": 70, "by_year": "2050", "basis": "material_specific" }
      ],
      "source_excerpt": "It is the goal of the State of Oregon that the statewide recycling rate
                         for plastic be: (A) At least 25 percent by calendar year 2028…"
    },
    "pro_structure": { "status": "present", "model": "competitive_pros", "source_excerpt": "…" },
    "eco_modulation": {
      "status": "present",
      "criteria": ["Post-consumer recycled content", "Product-to-package ratio", "Recyclability"],
      "source_excerpt": "…"
    }
    // …fee_amounts, penalties, recycled_content, bans_restrictions, labeling
  }
}

Each envelope carries a status of present, absent, or not_applicable — so a dimension a law genuinely does not address is distinguishable from one we have not extracted.