---
title: "Available Earning Years"
method: GET
path: "/v1/us/{datarun}/years"
tags: ["Meta"]
---

# Available Earning Years

`GET /v1/us/{datarun}/years`

## Request

- Base URL: `https://earnings.emsicloud.com`
- URL: `https://earnings.emsicloud.com/v1/us/{datarun}/years`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.emsicloud.com/connect/token` scopes: `occearn`

List the available earnings years in the datarun.

## Path parameters

- `datarun` '2025.2' | '2025.1' | '2024.4' | '2024.3' | '2024.2', required

## Response `200`

OK

- Schema (unresolved $ref)

---

[API](https://skmtc.dev/lightcast/apis/occupational-earnings-api.md) - [All operations](https://skmtc.dev/lightcast/apis/occupational-earnings-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lightcast/apis/occupational-earnings-api/revisions/43223d50ca36?raw)