Sections of Occupation Report

Returns one or more sections of a US occupation profile in a single request.

This is more efficient than /occupation/v3/fullreport when you only need specific data — for example, requesting Description and StateWages rather than the complete profile. Use fullreport only when all sections are required.

Request Parameters

Parameter	Type	Required	Description
`Country`	string	Yes	Must be `US`
`Code`	string	Yes	SOC occupation code (e.g., `291221` for Anesthesiologists)
`Language`	string	Yes	Report language (e.g., `English`)
`ReportSections`	array (string)	Yes	One or more section names to include in the response (see Available Sections below)

Available Sections Reference Table

Section Name	Param to include in `ReportSections` array	Description
Title	`Title`	Official occupation title as used in SOC classification and IBISWorld cataloging.
Report Year	`ReportYear`	Primary data year for the occupation profile.
Description	`Description`	Occupation scope and duties in `PlainText` and `HTML` formats. Sourced from BLS definitions.
National Wages	`NationalWages`	US national wage averages. Returns `WageRates.National` array.
State Wages	`StateWages`	Wage data for all 50 US states plus DC. Returns `WageRates.States` array.
Metropolitan Statistical Area Wages	`MetropolitanStatisticalAreaWages`	Wage data for all Metropolitan Statistical Areas (MSAs) where the occupation is present. Returns `WageRates.MetropolitanStatisticalArea` array.
All Wages	`AllWages`	Complete wage data across all geographic levels — National, States, and MSAs. Returns the full `WageRates` object.

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "Country": "US",
    "Code": "172011",
    "Language": "English",
    "ReportSections":  [
        "ReportYear",
        "Title",
        "Definition",
        "NationalWages",
        "StateWages",
        "MetropolitanStatisticalAreaWages",
        "AllWages"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

Example

{
    "Sections": [
        {
            "RequestedSection": "ReportYear",
            "StatusCode": 200,
            "Body": {
                "ReportYear": 2025
            }
        },
        {
            "RequestedSection": "Title",
            "StatusCode": 200,
            "Body": {
                "Title": "Aerospace Engineers"
            }
        },
        {
            "RequestedSection": "NationalWages",
            "StatusCode": 200,
            "Body": {
                "WageRates": {
                    "National": [
                        {
                            "AreaCode": "N",
                            "AreaName": "National",
                            "Metrics": [
                                {
                                    "Name": "Average",
                                    "ID": "03",
                                    "Unit": "$ per hour",
                                    "DataPoints": [
                                        {
                                            "Year": 2024,
                                            "Value": 67.88
                                        }
                                    ]
                                },
                                {
                                    "Name": "Entry Level",
                                    "ID": "07",
                                    "Unit": "$ per hour",
                                    "DataPoints": [
                                        {
                                            "Year": 2024,
                                            "Value": 50.36
                                        }
                                    ]
                                },
                                {
                                    "Name": "Median",
                                    "ID": "08",
                                    "Unit": "$ per hour",
                                    "DataPoints": [
                                        {
                                            "Year": 2024,
                                            "Value": 64.82
                                        }
                                    ]
                                },
                                {
                                    "Name": "Experienced",
                                    "ID": "09",
                                    "Unit": "$ per hour",
                                    "DataPoints": [
                                        {
                                            "Year": 2024,
                                            "Value": 83.88
                                        }
                                    ]
                                }
                            ]
                        }
                    ]
                }
            }
        },
        {
            "RequestedSection": "StateWages",
            "StatusCode": 200,
            "Body": {
                "WageRates": {
                    "States": [
                        {
                            "AreaCode": "0100000",
                            "AreaShortName": "AL",
                            "AreaName": "Alabama",
                            "Metrics": [
                                {
                                    "Name": "Average",
                                    "ID": "03",
                                    "Unit": "$ per hour",
                                    "DataPoints": [
                                        {
                                            "Year": 2024,
                                            "Value": 65.49
                                        }
                                    ]
                                },
                                {
                                    "Name": "Entry Level",
                                    "ID": "07",
                                    "Unit": "$ per hour",
                                    "DataPoints": [
                                        {
                                            "Year": 2024,
                                            "Value": 47.93
                                        }
                                    ]
                                },
                                {
                                    "Name": "Median",
                                    "ID": "08",
                                    "Unit": "$ per hour",
                                    "DataPoints": [
                                        {
                                            "Year": 2024,
                                            "Value": 63.98
                                        }
                                    ]
                                },

🟠403403

🟢204204

🟠401401