Compliance History

Retrieve violations, inspections, and penalties for a specific facility. These endpoints give you a complete compliance timeline.

Endpoints

GET/v1/facilities/{facility_id}/violationsPro+

List violations for a facility, with severity and date filtering.

GET/v1/facilities/{facility_id}/inspectionsPro+

List inspections for a facility, with program and findings filtering.

GET/v1/facilities/{facility_id}/penaltiesPro+

List penalties assessed against a facility, with amount filtering.

List violations

GET/v1/facilities/{facility_id}/violations

Query Parameters

Parameter	Type	Description
`program`	string	Filter by EPA program (CAA, CWA, RCRA, SDWA)`e.g. CAA`
`severity`	string	Filter by severity level`e.g. HIGH`
`is_active`	boolean	Only active/unresolved violations`e.g. true`
`since`	date	Violations after this date (YYYY-MM-DD)`e.g. 2024-01-01`
`until`	date	Violations before this date`e.g. 2026-03-20`
`page`	integer	Page number (default 1)
`per_page`	integer	Results per page (default 25, max 100)
`cursor`	string	Cursor for cursor-based pagination

programstring

Filter by EPA program (CAA, CWA, RCRA, SDWA)

e.g. CAA

severitystring

Filter by severity level

e.g. HIGH

is_activeboolean

Only active/unresolved violations

e.g. true

sincedate

Violations after this date (YYYY-MM-DD)

e.g. 2024-01-01

untildate

Violations before this date

e.g. 2026-03-20

pageinteger

Page number (default 1)

per_pageinteger

Results per page (default 25, max 100)

cursorstring

Cursor for cursor-based pagination

Request

curl "https://api.parley.dev/v1/facilities/f47ac10b-58cc-4372-a567-0e02b2c3d479/violations?severity=HIGH&is_active=true" \  -H "X-API-Key: prl_YOUR_KEY_HERE"

200OKapplication/json

{  "data": [    {      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",      "facility_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",      "program": "CAA",      "violation_type": "High Priority Violation",      "violation_code": "HPV",      "violation_description": "Failure to meet emission standard for volatile organic compounds",      "violation_date": "2025-11-22",      "compliance_schedule_date": "2026-05-22",      "resolved_date": null,      "severity": "HIGH",      "is_active": true    }  ],  "pagination": {    "total": 7,    "page": 1,    "per_page": 25,    "has_more": false  }}

Severity levels

HIGH — High Priority Violations (HPV) requiring immediate federal attention
SIGNIFICANT — Significant Non-Compliance (SNC) or Significant Violations (SV)
MINOR — Minor violations not meeting HPV or SNC thresholds

List inspections

GET/v1/facilities/{facility_id}/inspections

Query Parameters

Parameter	Type	Description
`program`	string	Filter by EPA program`e.g. CAA`
`lead_agency`	string	Filter by lead agency (EPA, STATE)`e.g. EPA`
`findings`	string	Filter by findings (VIOLATION, NO_VIOLATION)`e.g. VIOLATION`
`since`	date	Inspections after this date
`until`	date	Inspections before this date
`page`	integer	Page number
`per_page`	integer	Results per page

programstring

Filter by EPA program

e.g. CAA

lead_agencystring

Filter by lead agency (EPA, STATE)

e.g. EPA

findingsstring

Filter by findings (VIOLATION, NO_VIOLATION)

e.g. VIOLATION

sincedate

Inspections after this date

untildate

Inspections before this date

pageinteger

Page number

per_pageinteger

Results per page

Request

curl "https://api.parley.dev/v1/facilities/f47ac10b-.../inspections?since=2024-01-01" \  -H "X-API-Key: prl_YOUR_KEY_HERE"

List penalties

GET/v1/facilities/{facility_id}/penalties

Query Parameters

Parameter	Type	Description
`penalty_type`	string	Filter by type (FEDERAL, STATE)`e.g. FEDERAL`
`min_amount`	float	Minimum penalty amount in dollars`e.g. 10000`
`max_amount`	float	Maximum penalty amount`e.g. 500000`
`since`	date	Penalties after this date
`until`	date	Penalties before this date
`page`	integer	Page number
`per_page`	integer	Results per page

penalty_typestring

Filter by type (FEDERAL, STATE)

e.g. FEDERAL

min_amountfloat

Minimum penalty amount in dollars

e.g. 10000

max_amountfloat

Maximum penalty amount

e.g. 500000

sincedate

Penalties after this date

untildate

Penalties before this date

pageinteger

Page number

per_pageinteger

Results per page

Request

curl "https://api.parley.dev/v1/facilities/f47ac10b-.../penalties?min_amount=50000" \  -H "X-API-Key: prl_YOUR_KEY_HERE"

200OKapplication/json

{  "data": [    {      "id": "p1a2b3c4-...",      "case_id": "c9d8e7f6-...",      "facility_id": "f47ac10b-...",      "penalty_type": "FEDERAL",      "amount": 75000.00,      "penalty_date": "2025-06-30"    }  ],  "pagination": {    "total": 3,    "page": 1,    "per_page": 25,    "has_more": false  }}