Enforcement Cases
Search and retrieve EPA enforcement cases, including civil and criminal actions linked to specific facilities.
Endpoints
GET
/v1/casesPro+Search enforcement cases with filtering by type, program, agency, and date.
GET
/v1/cases/{case_id}Pro+Get complete case details including linked facilities and penalties.
Search cases
GET
/v1/casesQuery Parameters
| Parameter | Type | Description |
|---|---|---|
q | string | Search case name or case numbere.g. ACME Chemical |
case_type | string | Case type: CIVIL or CRIMINALe.g. CIVIL |
lead_agency | string | Lead enforcement agency: EPA or STATEe.g. EPA |
program | string | EPA program (CAA, CWA, RCRA, SDWA)e.g. CAA |
status | string | Case status (e.g. OPEN, SETTLED, CLOSED) |
facility_id | uuid | Filter cases involving a specific facility |
since | date | Cases filed after this date (YYYY-MM-DD) |
until | date | Cases filed before this date |
page | integer | Page number (default 1) |
per_page | integer | Results per page (default 25, max 100) |
cursor | string | Cursor for cursor-based pagination |
qstringSearch case name or case number
e.g. ACME Chemicalcase_typestringCase type: CIVIL or CRIMINAL
e.g. CIVILlead_agencystringLead enforcement agency: EPA or STATE
e.g. EPAprogramstringEPA program (CAA, CWA, RCRA, SDWA)
e.g. CAAstatusstringCase status (e.g. OPEN, SETTLED, CLOSED)
facility_iduuidFilter cases involving a specific facility
sincedateCases filed after this date (YYYY-MM-DD)
untildateCases filed before this date
pageintegerPage number (default 1)
per_pageintegerResults per page (default 25, max 100)
cursorstringCursor for cursor-based pagination
Request
curl "https://api.parley.dev/v1/cases?case_type=CIVIL&program=CAA&since=2024-01-01" \ -H "X-API-Key: prl_YOUR_KEY_HERE"200OKapplication/json
{ "data": [ { "id": "c9d8e7f6-a1b2-3c4d-5e6f-7890abcdef12", "case_number": "02-2025-1234", "case_name": "United States v. ACME Chemical Inc.", "case_type": "CIVIL", "lead_agency": "EPA", "status": "SETTLED", "filing_date": "2025-03-15", "settlement_date": "2025-09-22", "programs": ["CAA"] } ], "pagination": { "total": 12, "page": 1, "per_page": 25, "has_more": false }}Get case details
GET
/v1/cases/{case_id}Path Parameters
| Parameter | Type | Description |
|---|---|---|
case_id* | uuid | The case UUIDe.g. c9d8e7f6-a1b2-3c4d-5e6f-7890abcdef12 |
case_idrequireduuidThe case UUID
e.g. c9d8e7f6-a1b2-3c4d-5e6f-7890abcdef12Request
curl "https://api.parley.dev/v1/cases/c9d8e7f6-a1b2-3c4d-5e6f-7890abcdef12" \ -H "X-API-Key: prl_YOUR_KEY_HERE"200OKapplication/json
{ "data": { "id": "c9d8e7f6-a1b2-3c4d-5e6f-7890abcdef12", "case_number": "02-2025-1234", "case_name": "United States v. ACME Chemical Inc.", "case_type": "CIVIL", "lead_agency": "EPA", "status": "SETTLED", "filing_date": "2025-03-15", "settlement_date": "2025-09-22", "programs": ["CAA"], "statutes": ["Clean Air Act"], "facilities": [ { "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "frs_id": "110000000001", "name": "ACME CHEMICAL PLANT", "state": "TX" } ], "penalties": [ { "id": "p1a2b3c4-...", "penalty_type": "FEDERAL", "amount": 75000.00, "penalty_date": "2025-06-30" }, { "id": "p2b3c4d5-...", "penalty_type": "FEDERAL", "amount": 50000.00, "penalty_date": "2025-09-22" } ], "last_synced_at": "2026-03-19T04:00:00Z" }, "meta": { "request_id": "req_4c5d6e7f", "timestamp": "2026-03-20T12:00:00Z" }}