Api Endpoint

tollbooth

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.

Open interactive test console

Offering

Provider
api.flipvo.com
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Legal And Compliance
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api.flipvo.com/v1/osha/history
MIME type
Not provided
First seen
2026-10-16T01:50:38.788Z
Last seen
Tags
compliance, osha, workplace-safety, employer

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.02 USDC
Atomic price: 20000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "20000",
    "payTo": "0x849610c11c1e9b309235932faab6368cee7f7c57"
  }
]

Observed health

Status
Reachable
Latest latency
45 ms
Average latency
69 ms
HTTP status
405
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "additionalProperties": false,
      "description": "An employer and the state it works in; city and zip only narrow.",
      "properties": {
        "city": {
          "anyOf": [
            {
              "maxLength": 60,
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Inspection site city, case-insensitive. A hard filter.",
          "examples": [
            "Lubbock"
          ],
          "title": "City"
        },
        "employer": {
          "description": "Employer name, with at least one word that is not a generic trade word.",
          "examples": [
            "Walmart"
          ],
          "maxLength": 150,
          "minLength": 2,
          "title": "Employer",
          "type": "string"
        },
        "limit": {
          "default": 10,
          "description": "Establishments returned, 1-25.",
          "maximum": 25,
          "minimum": 1,
          "title": "Limit",
          "type": "integer"
        },
        "min_score": {
          "default": 85,
          "description": "Name score floor, 70-100.",
          "maximum": 100,
          "minimum": 70,
          "title": "Min Score",
          "type": "integer"
        },
        "state": {
          "description": "US state or territory code. A hard filter on the inspection site.",
          "examples": [
            "TX"
          ],
          "maxLength": 2,
          "minLength": 2,
          "title": "State",
          "type": "string"
        },
        "zip": {
          "anyOf": [
            {
              "pattern": "^[0-9]{5}$",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Five-digit inspection site ZIP. A hard filter.",
          "examples": [
            "79404"
          ],
          "title": "Zip"
        }
      },
      "required": [
        "employer",
        "state"
      ],
      "title": "OshaHistoryRequest",
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST",
        "PUT",
        "PATCH"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "example": {
      "properties": {
        "coverage": {
          "title": "Coverage",
          "type": "string"
        },
        "data_as_of": {
          "additionalProperties": {
            "type": "string"
          },
          "title": "Data As Of",
          "type": "object"
        },
        "establishments": {
          "items": {
            "properties": {
              "city": {
                "title": "City",
                "type": "string"
              },
              "inspections": {
                "items": {
                  "properties": {
                    "activity_nr": {
                      "title": "Activity Nr",
                      "type": "integer"
                    },
                    "closed": {
                      "anyOf": [
                        {
                          "format": "date",
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Closed"
                    },
                    "opened": {
                      "anyOf": [
                        {
                          "format": "date",
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Opened"
                    },
                    "scope": {
                      "description": "OSHA's inspection scope letter, as OSHA lists it.",
                      "title": "Scope",
                      "type": "string"
                    },
                    "type": {
                      "description": "OSHA's inspection type letter, as OSHA lists it.",
                      "title": "Type",
                      "type": "string"
                    },
                    "violations": {
                      "items": {
                        "properties": {
                          "abated": {
                            "anyOf": [
                              {
                                "format": "date",
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Abated"
                          },
                          "citation_id": {
                            "title": "Citation Id",
                            "type": "string"
                          },
                          "contested": {
                            "anyOf": [
                              {
                                "format": "date",
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Contested"
                          },
                          "current_penalty": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Current Penalty"
                          },
                          "exposed": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Exposed"
                          },
                          "final_order": {
                            "anyOf": [
                              {
                                "format": "date",
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Final Order"
                          },
                          "gravity": {
                            "title": "Gravity",
                            "type": "string"
                          },
                          "initial_penalty": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Initial Penalty"
                          },
                          "instances": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Instances"
                          },
                          "issued": {
                            "anyOf": [
                              {
                                "format": "date",
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Issued"
                          },
                          "standard": {
                            "title": "Standard",
                            "type": "string"
                          },
                          "type": {
                            "description": "OSHA's violation type letter: S, W, R, O or U.",
                            "title": "Type",
                            "type": "string"
                          }
                        },
                        "required": [
                          "citation_id",
                          "standard",
                          "type",
                          "issued",
                          "current_penalty",
                          "initial_penalty",
                          "abated",
                          "contested",
                          "final_order",
                          "instances",
                          "exposed",
                          "gravity"
                        ],
                        "title": "OshaViolation",
                        "type": "object"
                      },
                      "title": "Violations",
                      "type": "array"
                    }
                  },
                  "required": [
                    "activity_nr",
                    "opened",
                    "type",
                    "scope",
                    "closed",
                    "violations"
                  ],
                  "title": "OshaInspection",
                  "type": "object"
                },
                "title": "Inspections",
                "type": "array"
              },
              "inspections_truncated": {
                "title": "Inspections Truncated",
                "type": "boolean"
              },
              "match_score": {
                "title": "Match Score",
                "type": "integer"
              },
              "names": {
                "description": "Each spelling OSHA used at this site.",
                "items": {
                  "type": "string"
                },
                "title": "Names",
                "type": "array"
              },
              "rollup": {
                "properties": {
                  "inspections": {
                    "title": "Inspections",
                    "type": "integer"
                  },
                  "last_inspection": {
                    "anyOf": [
                      {
                        "format": "date",
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "title": "Last Inspection"
                  },
                  "other": {
                    "title": "Other",
                    "type": "integer"
                  },
                  "repeat": {
                    "title": "Repeat",
                    "type": "integer"
                  },
                  "serious": {
                    "title": "Serious",
                    "type": "integer"
                  },
                  "total_current_penalty": {
                    "description": "Decimal string; a null penalty counts as 0.",
                    "title": "Total Current Penalty",
                    "type": "string"
                  },
                  "violations": {
                    "title": "Violations",
                    "type": "integer"
                  },
                  "willful": {
                    "title": "Willful",
                    "type": "integer"
                  }
                },
                "required": [
                  "inspections",
                  "violations",
                  "total_current_penalty",
                  "serious",
                  "willful",
                  "repeat",
                  "other",
                  "last_inspection"
                ],
                "title": "OshaRollup",
                "type": "object"
              },
              "state": {
                "title": "State",
                "type": "string"
              },
              "zip": {
                "title": "Zip",
                "type": "string"
              }
            },
            "required": [
              "names",
              "city",
              "state",
              "zip",
              "match_score",
              "rollup",
              "inspections",
              "inspections_truncated"
            ],
            "title": "OshaEstablishment",
            "type": "object"
          },
          "title": "Establishments",
          "type": "array"
        },
        "rollup": {
          "properties": {
            "inspections": {
              "title": "Inspections",
              "type": "integer"
            },
            "last_inspection": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Last Inspection"
            },
            "other": {
              "title": "Other",
              "type": "integer"
            },
            "repeat": {
              "title": "Repeat",
              "type": "integer"
            },
            "serious": {
              "title": "Serious",
              "type": "integer"
            },
            "total_current_penalty": {
              "description": "Decimal string; a null penalty counts as 0.",
              "title": "Total Current Penalty",
              "type": "string"
            },
            "violations": {
              "title": "Violations",
              "type": "integer"
            },
            "willful": {
              "title": "Willful",
              "type": "integer"
            }
          },
          "required": [
            "inspections",
            "violations",
            "total_current_penalty",
            "serious",
            "willful",
            "repeat",
            "other",
            "last_inspection"
          ],
          "title": "OshaRollup",
          "type": "object"
        },
        "source": {
          "title": "Source",
          "type": "string"
        },
        "total_establishments": {
          "title": "Total Establishments",
          "type": "integer"
        },
        "truncated": {
          "title": "Truncated",
          "type": "boolean"
        }
      },
      "required": [
        "establishments",
        "total_establishments",
        "truncated",
        "rollup",
        "data_as_of",
        "coverage",
        "source"
      ],
      "title": "OshaHistoryResponse",
      "type": "object"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}