---
title: "List pay inputs"
method: GET
path: "/v3/pay_inputs"
tags: ["Pay Inputs"]
---

# List pay inputs

`GET /v3/pay_inputs`

Pay inputs are the individual compensation components (e.g. `Base Salary`, `Sign-on Bonus`, `Equity`) that make up a Greenhouse pay transparency rule. Site Admins configure them under Configure > Privacy & Compliance, and each pay input belongs to a pay transparency rule that gets attached to a job post; the dollar amounts themselves live on the sibling `/v3/pay_input_ranges` resource. Pay inputs may optionally sync from a currency-range custom job field via `linked_custom_field_id` — when present, the pay range is sourced from that field and is locked on the job post if `locked` is `true`.

## 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
- `linked_custom_field_ids` integer[]
- `fields` string[]

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `title` string — Label shown to candidates above this pay component on the job post (e.g. `Base Salary`, `Sign-on Bonus`, `Equity`). Configured by Site Admins under Configure > Privacy & Compliance and not editable from the job post.
  - `blurb` string, nullable — Optional descriptive copy shown alongside `title` on the job post — typically context or caveats about the component (e.g. `Annual base salary, exclusive of variable compensation`). May contain sanitized HTML. `null` when no description was supplied.
  - `priority` integer — Display order within the parent pay transparency rule. Lower values render first on the job post; pay inputs share this ordering with their associated `pay_input_ranges`.
  - `linked_custom_field_id` integer, nullable — Id of the currency-range custom job field this pay input syncs from, or `null` when the range is entered directly on each job post. When set, the pay range on the job post is sourced from the linked custom field rather than from manual entry.
  - `locked` boolean — `true` when the linked custom field is the single source of truth and the pay range is not editable on the job post — set by the Site Admin via the `Mark the value as not editable on the job post` setting. Always `false` when `linked_custom_field_id` is `null`.

---

[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)