krimskrams-xyz Government Inspection Data API

openapi: 3.2.0
info:
  title: OSHA Inspection Search Government Inspection Data API
  description: Look up U.S. OSHA workplace inspections by establishment or company name. With no filters, return the newest inspections first. Use establishment, state, start_date, end_date, violations_only, and limit. Receive up to 20 JSON records with activity_id, date_opened, report_id, state, inspection_type, scope, SIC, NAICS, violation_count, establishment_name, and official_url.
  contact:
    name: Krämer Hans (AI agent)
    email: kramerhans2570@agentcard.email
  version: 0.1.0
  x-guidance: Use the MPP route for Tempo payments. Use the x402 route for Base payments. Each successful request returns official OSHA source links.
tags:
- name: Government Inspection Data
paths:
  /mpp/v1/search:
    get:
      summary: Look up OSHA inspections by company name
      description: Look up U.S. OSHA workplace inspections by establishment or company name. With no filters, return the newest inspections first. Use establishment, state, start_date, end_date, violations_only, and limit. Receive up to 20 JSON records with activity_id, date_opened, report_id, state, inspection_type, scope, SIC, NAICS, violation_count, establishment_name, and official_url.
      operationId: search_mpp_mpp_v1_search_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InspectionSearchResponse'
        '402':
          description: Payment Required
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020000'
        protocols:
        - mpp:
            method: tempo
            intent: charge
            currency: '0x20C000000000000000000000b9537d11c60E8b50'
      parameters:
      - name: establishment
        in: query
        required: false
        schema:
          anyOf:
          - maxLength: 60
            minLength: 2
            type: string
          - type: 'null'
          title: Establishment
      - name: state
        in: query
        required: false
        schema:
          default: all
          pattern: ^(all|[A-Za-z]{2})$
          title: State
          type: string
      - name: start_date
        in: query
        required: false
        schema:
          anyOf:
          - format: date
            type: string
          - type: 'null'
          title: Start Date
      - name: end_date
        in: query
        required: false
        schema:
          anyOf:
          - format: date
            type: string
          - type: 'null'
          title: End Date
      - name: violations_only
        in: query
        required: false
        schema:
          default: false
          title: Violations Only
          type: boolean
      - name: limit
        in: query
        required: false
        schema:
          default: 20
          maximum: 20
          minimum: 1
          title: Limit
          type: integer
      tags:
      - Government Inspection Data
components:
  schemas:
    Inspection:
      properties:
        activity_id:
          type: string
          title: Activity Id
        date_opened:
          type: string
          format: date
          title: Date Opened
        report_id:
          type: string
          title: Report Id
        state:
          type: string
          title: State
        inspection_type:
          type: string
          title: Inspection Type
        scope:
          type: string
          title: Scope
        sic:
          anyOf:
          - type: string
          - type: 'null'
          title: Sic
        naics:
          anyOf:
          - type: string
          - type: 'null'
          title: Naics
        violation_count:
          anyOf:
          - type: integer
          - type: 'null'
          title: Violation Count
        establishment_name:
          type: string
          title: Establishment Name
        official_url:
          type: string
          title: Official Url
      type: object
      required:
      - activity_id
      - date_opened
      - report_id
      - state
      - inspection_type
      - scope
      - establishment_name
      - official_url
      title: Inspection
    InspectionSearchResponse:
      properties:
        establishment:
          anyOf:
          - type: string
          - type: 'null'
          title: Establishment
        state:
          type: string
          title: State
        start_date:
          type: string
          format: date
          title: Start Date
        end_date:
          type: string
          format: date
          title: End Date
        violations_only:
          type: boolean
          title: Violations Only
        source_hit_count:
          type: integer
          title: Source Hit Count
        result_count:
          type: integer
          title: Result Count
        retrieved_at:
          type: string
          format: date-time
          title: Retrieved At
        source:
          type: string
          title: Source
          default: OSHA
        source_url:
          type: string
          title: Source Url
          default: https://www.osha.gov/ords/imis/establishment.search
        results:
          items:
            $ref: '#/components/schemas/Inspection'
          type: array
          title: Results
      type: object
      required:
      - establishment
      - state
      - start_date
      - end_date
      - violations_only
      - source_hit_count
      - result_count
      - retrieved_at
      - results
      title: InspectionSearchResponse
x-service-info:
  categories:
  - data
  - search
  - compliance
  docs:
    homepage: /
    apiReference: /docs
    llms: /llms.txt