# OSHA Inspection History by Employer

> OSHA Inspection History by Employer is a paid API for AI agents from api.flipvo.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-11).

Returns OSHA inspection records, violations, and penalties on file for a named employer at a given US state location, aggregated as establishments with a penalty roll-up.

## Facts

- Endpoint: POST https://api.flipvo.com/v1/osha/history?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/osha-inspection-history-by-employer-cc19f84b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NhFAcJL151I6lKAqMXzmc

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability osha-inspection-history-by-employer-cc19f84b -d '<json body>'
```

Example prompt: Can you pull up the OSHA inspection history for Walmart in Texas — check the state of TX, and show me up to 10 matching establishments with their violations and penalties?

## When to prefer this

Use this endpoint when you need to look up US OSHA regulatory enforcement history (inspections, violations, penalties) for a specific named employer in a given state. Prefer this over general web search when you need structured, machine-readable compliance data sourced directly from DOL files with fuzzy name matching. Best suited for employer due diligence, contractor vetting, supply chain compliance screening, or investigative research into workplace safety records.

## Known failure modes

- Employer name not specific enough — generic trade words alone will not match; requires at least one non-generic word
- No OSHA records found — employer may genuinely have no inspection history; empty result is still a paid 200
- State code missing or invalid — state is required and must be a 2-character US state/territory code
- ZIP or city mismatch — if provided, ZIP and city act as hard filters and may exclude valid establishments
- Name score too high — raising min_score above 85 may miss fuzzy matches for common name variants
- Name score too low — dropping min_score below 80 may return false-positive establishments

## How this service works

Returns the OSHA inspections, violations and penalties on file for an employer in a state (optional city and zip), matched by name in the US Department of Labor's inspection and violation files, as establishments with a penalty roll-up; OSHA inspections only, so an employer with none has no record and an empty result is a paid 200; it is not a determination about the employer and is not endorsed or certified by the U.S. Department of Labor.

## Output

A list of matched employer establishments (up to the specified limit) with their OSHA inspection records, violation details, and aggregated penalty amounts. Each establishment is matched by fuzzy name scoring against the DOL inspection files. If no inspections exist for the employer, returns an empty result with HTTP 200. The response is informational only and is not an endorsement or certification by the US Department of Labor.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "zip": {
   "anyOf": [
    {
     "type": "string",
     "pattern": "^[0-9]{5}$"
    },
    {
     "type": "null"
    }
   ],
   "title": "Zip",
   "default": null,
   "examples": [
    "79404"
   ],
   "description": "Five-digit inspection site ZIP. A hard filter."
  },
  "city": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 60,
     "minLength": 1
    },
    {
     "type": "null"
    }
   ],
   "title": "City",
   "default": null,
   "examples": [
    "Lubbock"
   ],
   "description": "Inspection site city, case-insensitive. A hard filter."
  },
  "limit": {
   "type": "integer",
   "title": "Limit",
   "default": 10,
   "maximum": 25,
   "minimum": 1,
   "description": "Establishments returned, 1-25."
  },
  "state": {
   "type": "string",
   "title": "State",
   "examples": [
    "TX"
   ],
   "maxLength": 2,
   "minLength": 2,
   "description": "US state or territory code. A hard filter on the inspection site."
  },
  "employer": {
   "type": "string",
   "title": "Employer",
   "examples": [
    "Walmart"
   ],
   "maxLength": 150,
   "minLength": 2,
   "description": "Employer name, with at least one word that is not a generic trade word."
  },
  "min_score": {
   "type": "integer",
   "title": "Min Score",
   "default": 85,
   "maximum": 100,
   "minimum": 70,
   "description": "Name score floor, 70-100."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "rollup": {
   "other": 0,
   "repeat": 0,
   "serious": 1,
   "willful": 0,
   "violations": 1,
   "inspections": 1,
   "last_inspection": "2024-03-11",
   "total_current_penalty": "4500.00"
  },
  "source": "US Department of Labor OSHA inspection and violation data (https://enforcedata.dol.gov)",
  "coverage": "OSHA inspections only, from the Department of Labor's bulk inspection and violation files: a site with no inspection in these files has no row here, and an empty result says nothing else about the employer. States that run their own state plan may be partly absent. Withdrawn citations are left out of every list and total. Employer names are matched, not verified: confirm a site before acting on it. Penalties are the current amounts OSHA lists. Not endorsed or certified by the U.S. Department of Labor.",
  "truncated": false,
  "data_as_of": {
   "violations": "2026-10-01T11:11:27Z",
   "inspections": "2026-10-01T11:04:25Z"
  },
  "establishments": [
   {
    "zip": "79404",
    "city": "Lubbock",
    "names": [
     "ACME WAREHOUSING INC"
    ],
    "state": "TX",
    "rollup": {
     "other": 0,
     "repeat": 0,
     "serious": 1,
     "willful": 0,
     "violations": 1,
     "inspections": 1,
     "last_inspection": "2024-03-11",
     "total_current_penalty": "4500.00"
    },
    "inspections": [
     {
      "type": "B",
      "scope": "B",
      "closed": "2024-08-30",
      "opened": "2024-03-11",
      "violations": [
       {
        "type": "S",
        "abated": "2024-06-24",
        "issued": "2024-05-20",
        "exposed": 3,
        "gravity": "10",
        "standard": "19100178 L01",
        "contested": null,
        "instances": 1,
        "citation_id": "01001",
        "final_order": null,
        "current_penalty": "4500.00",
        "initial_penalty": "5000.00"
       }
      ],
      "activity_nr": 1002
     }
    ],
    "match_score": 100,
    "inspections_truncated": false
   }
  ],
  "total_establishments": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/osha-inspection-history-by-employer-cc19f84b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.flipvo.com](https://www.zero.xyz/host/api.flipvo.com/llms.txt)
