v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Salary Estimates

Search for BLS occupations

Search for Bureau of Labor Statistics (BLS) occupations by name or keyword. This endpoint helps users find the appropriate occupation codes to use when creating or updating salary estimates.

Returns a list of matching occupations with their codes, titles, and descriptions.

📘 System Access Authentication

This endpoint uses the Bearer Auth scheme with the system-level access token in the HTTP Authorization header

scope: salary_estimates:read

get/v1/salary_estimates/occupations

Query parameters

searchstring required

Search term for occupation (minimum 3 characters)

Headers

X-Gusto-API-Version'2026-06-15'

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Response

successful

codestring required

Bureau of Labor Statistics (BLS) occupation code.

titlestring required

Occupation title.

descriptionstring

Occupation description.

Example response

[
  {
    "code": "15-1252",
    "title": "Software Developers",
    "description": "Research, design, and develop computer and network software or specialized utility programs."
  }
]