H-1B Visa Salary Records (by Year, Paginated)

{
  "type": "object",
  "required": [
    "year"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "description": "Page number for pagination (starts at 1)."
    },
    "year": {
      "type": "integer",
      "description": "Year of H-1B records. Valid values include 2020 through 2025."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "page": {
          "type": "number",
          "description": "Echoes the requested page number."
        },
        "year": {
          "type": "number",
          "description": "Echoes the requested year."
        },
        "records": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "city": {
                "type": "string",
                "description": "Worksite city."
              },
              "wage": {
                "type": "number",
                "description": "Annual wage in USD."
              },
              "year": {
                "type": "number",
                "description": "Filing year, matching the requested year."
              },
              "state": {
                "type": "string",
                "description": "Worksite state abbreviation."
              },
              "company": {
                "type": "string",
                "description": "The sponsoring employer's name."
              },
              "hd_flag": {
                "type": "number",
                "description": "Present only on some records, always observed as 1 when present, absent otherwise. Meaning is not documented by the provider and was not confirmed from any real call -- treat as an opaque flag, not guaranteed to be present."
              },
              "job_title": {
                "type": "string",
                "description": "The employer's own job title."
              },
              "soc_title": {
                "type": "string",
                "description": "The standardized occupation title the job title maps to."
              },
              "wage_level": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "DOL prevailing-wage level, e.g. 'II'/'III'/'IV'. Observed null on many records in the one populated fixture -- do not assume this is always present."
              },
              "case_status": {
                "type": "string",
                "description": "e.g. 'Certified', 'Certified - Withdrawn' -- observed values from the one populated fixture, not an exhaustive enum."
              },
              "employer_type": {
                "type": "string",
                "description": "A short employer-classification code (single letters observed: C, E, N, A, P, X). The provider does not document what each letter stands for and no legend was observed in any real call -- pass through as an opaque code."
              },
              "company_domain": {
                "type": "string",
                "description": "The sponsoring employer's own web domain, e.g. 'google.com'."
              },
              "lca_accepted_date": {
                "type": "string",
                "description": "The date the filing was accepted, e.g. 'Oct 22, 2024'."
              },
              "employment_begin_date": {
                "type": "string",
                "description": "e.g. 'Dec 31, 2024'."
              }
            },
            "additionalProperties": true
          },
          "description": "Up to 100 records on the one populated page observed."
        },
        "totalPages": {
          "type": "number",
          "description": "Total pages available for this year at the page size observed (100)."
        },
        "totalRecords": {
          "type": "number",
          "description": "Total records available for this year."
        }
      },
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "'success' on the one populated call observed."
    }
  },
  "description": "The H-1B salary page record, as returned at routing.responseResultPath ($.output). A page past the last one for the requested year shapes to an empty object ({}) -- this is a genuine 'no more pages' result, not an error.",
  "additionalProperties": true
}