# Violationtracker Goodjobsfirst — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search corporate violations and regulatory penalties across companies, industries, and agencies to research misconduct records and enforcement actions. Get detailed information about specific violations, parent company compliance histories, and regulatory agency enforcement patterns.

**Category:** Government & Public Data | **Website:** [violationtracker.goodjobsfirst.org/](https://violationtracker.goodjobsfirst.org/) | **Docs:** [parse.bot/marketplace/5be00420-4477-4036-9a76-87cf121072b4/violationtracker-goodjobsfirst-org-api](https://parse.bot/marketplace/5be00420-4477-4036-9a76-87cf121072b4/violationtracker-goodjobsfirst-org-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-violationtracker-goodjobsfirst-org-api-5be00420/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_agency_summary

Retrieves summary data for a regulatory agency including penalty totals, top 10 parent companies by penalty, and recent major violations. The agency_code is available from list_agencies.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `agency_code` | string | Yes | Agency code (e.g. 'EPA', 'OSHA', 'SEC'). Available from list_agencies endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-violationtracker-goodjobsfirst-org-api-5be00420/get_agency_summary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agency_code":"<string>"}'
```

### get_parent_company_summary

Retrieves a comprehensive summary for a parent company including penalty totals, top offense groups, top offense types, and individual violation records. The parent_id slug is available from list_parents or from search_violations results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `parent_id` | string | Yes | Parent company ID slug (e.g. 'exxon-mobil', '3m-company', 'bp'). Available from list_parents endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-violationtracker-goodjobsfirst-org-api-5be00420/get_parent_company_summary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"parent_id":"<string>"}'
```

### get_violation_detail

Fetches the full record for a single corporate violation by its ID slug. Returns structured fields including company name, penalty, year, offense description, agency, case details, and parent company information. The violation_id slug is available from search_violations results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `violation_id` | string | Yes | Violation record ID slug (e.g. 'ak-exxon-corporation'). Available from search_violations results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-violationtracker-goodjobsfirst-org-api-5be00420/get_violation_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"violation_id":"<string>"}'
```

### list_agencies

Returns the complete catalog of federal regulatory agencies tracked in Violation Tracker. Each entry provides the full agency name and its code used as the agency_code parameter in get_agency_summary and search_violations.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-violationtracker-goodjobsfirst-org-api-5be00420/list_agencies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_parents

Returns the complete catalog of parent companies tracked in Violation Tracker. Each entry provides a display name and a URL slug (value) used as the parent_id parameter in get_parent_company_summary. The full list contains 3400+ entries returned in a single response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-violationtracker-goodjobsfirst-org-api-5be00420/list_parents \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_violations

Full-text search over corporate violation records with filters on company, agency, year, penalty amount, offense group, and industry. Returns paginated results sorted by penalty amount descending by default. Each result includes the violation ID slug for drilling into full details via get_violation_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `action_type` | string | No | Action type filter. |
| `agency_code` | string | No | Agency code filter (e.g. 'EPA', 'OSHA', 'SEC'). |
| `case_type` | string | No | Case type filter. |
| `company` | string | No | Company name to search for. |
| `company_op` | string | No | Company name match operator. |
| `federal_agency` | string | No | Federal agency filter (comma-separated for multiple). |
| `level_of_government` | string | No | Level of government filter. |
| `major_industry` | string | No | Major industry filter (comma-separated for multiple). |
| `offense_group` | string | No | Offense group filter. |
| `offense_type` | string | No | Offense type filter. |
| `order` | string | No | Sort order. |
| `page` | integer | No | Page number for pagination (1-based). |
| `parent_name` | string | No | Parent company name filter. |
| `parent_op` | string | No | Parent name match operator. |
| `pen_op` | string | No | Penalty comparison operator. |
| `penalty_amount` | string | No | Minimum penalty amount. |
| `presidential_administration` | string | No | Presidential administration filter. |
| `sort` | string | No | Sort field. |
| `state_local_agency` | string | No | State/local agency filter (comma-separated for multiple). |
| `year` | string | No | Year filter (comma-separated for multiple, e.g. '2020,2021,2022'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-violationtracker-goodjobsfirst-org-api-5be00420/search_violations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action_type":"<string>","agency_code":"<string>","case_type":"<string>","company":"<string>","company_op":"<string>","federal_agency":"<string>","level_of_government":"<string>","major_industry":"<string>","offense_group":"<string>","offense_type":"<string>","order":"<string>","page":"<integer>","parent_name":"<string>","parent_op":"<string>","pen_op":"<string>","penalty_amount":"<string>","presidential_administration":"<string>","sort":"<string>","state_local_agency":"<string>","year":"<string>"}'
```