---
title: "Salary Totals"
method: GET
path: "/employer-salaries/totals"
tags: ["Employer Salaries"]
---

# Salary Totals

`GET /employer-salaries/totals`

## Request

- Base URL: `https://api.dataporium.io`
- URL: `https://api.dataporium.io/employer-salaries/totals`
- Auth: API key in query parameter `apikey`

Yearly pay that employers offered in certified work-visa filings, from official public data: H-1B temporary work visas (kind h1b, with H-1B1), E-3 work visas (e3) and PERM green card filings (perm), by fiscal year (October to September) since 2020. All employers together: by=year gives one row per fiscal year for the US, one area or one job group; by=state, metro, city or job ranks places or job groups for one fiscal year. Pay is the lower end of the offered pay range, made yearly, for full-time positions only. These are offered pay figures in work-visa filings, not the pay of all workers; a filing is an offer for a position, not a hire.

The answer is {by, kind, year, filters, total, rows, as_of, about}. Until the first load is finished, lists answer with empty rows and note "Data is being prepared".

## Query parameters

- `by` string
- `kind` string
- `year` integer
- `job` string
- `area` string
- `state` string
- `sort` string
- `min_filings` integer
- `limit` integer

## Response `200`

Successful response (JSON).

- object

## Other responses

- `401`: No API key in the request.
- `403`: The API key is not valid or has expired.

---

[API](https://skmtc.dev/dataporium/apis/dataporium-data-api.md) · [All operations](https://skmtc.dev/dataporium/apis/dataporium-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dataporium/apis/dataporium-data-api/revisions/8bc593179dc8?raw)