---
title: "List pay input ranges"
method: GET
path: "/v3/pay_input_ranges"
tags: ["Pay Input Ranges"]
---

# List pay input ranges

`GET /v3/pay_input_ranges`

Pay input ranges are the per-job-post minimum and maximum values for a pay component (e.g. base salary, bonus) referenced by a pay transparency rule. Each range belongs to one `pay_input` and one `job_post`; the same job can publish different ranges on different posts. Greenhouse renders these ranges on public job posts to satisfy pay transparency laws (e.g. NY, CA, CO). `min_cents` and `max_cents` are expressed in the smallest unit of `currency_type` and are `0` when the range has not yet been filled in on the job post.

## Query parameters

- `cursor` string
- `per_page` integer
- `ids` integer[]
- `created_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `updated_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `pay_input_ids` integer[]
- `job_post_ids` integer[]
- `fields` string[]

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `pay_input_id` integer — Id of the `pay_input` this range fills in (e.g. the `Base Salary` pay input on a pay transparency rule). Multiple ranges can share a `pay_input` when a job post has more than one component (e.g. base salary plus bonus).
  - `currency_type` string — ISO 4217 currency code for `min_cents` and `max_cents` (e.g. `USD`, `EUR`, `GBP`). Defaults to `USD`.
  - `min_cents` integer — Lower bound of the pay range, expressed in the smallest unit of `currency_type` (e.g. cents for `USD`). `0` when the range has not been filled in on the job post.
  - `max_cents` integer — Upper bound of the pay range, expressed in the smallest unit of `currency_type` (e.g. cents for `USD`). `0` when the range has not been filled in on the job post.
  - `job_post_id` integer — Id of the `job_post` this range is attached to. Pay transparency ranges are stored per job post so the same job can publish different ranges on different posts.

---

[API](https://skmtc.dev/greenhouse/apis/auth-api.md) · [All operations](https://skmtc.dev/greenhouse/apis/auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greenhouse/auth-api/revisions/9517a2e54640/schema)
