---
title: "Return enriched compensation history rows (one row per comp change), in descending date order"
method: GET
path: "/v1/org/{orgId}/change/compensation-history"
tags: ["change"]
---

# Return enriched compensation history rows (one row per comp change), in descending date order

`GET /v1/org/{orgId}/change/compensation-history`

## Request

- Base URL: `https://localhost`
- URL: `https://localhost/v1/org/{orgId}/change/compensation-history`
- Auth: none declared

## Path parameters

- `orgId` string, required

## Query parameters

- `startDate` string, date
- `endDate` string, date
- `q` string
- `from` integer
- `limit` integer
- `format` string

## Response `200`

successful operation

- ResultsCompensationHistoryRow
  - `data` CompensationHistoryRow[], required
    - `changeId` string, required: id of the change that produced this row
    - `personId` string: person id at the time of the change
    - `jobId` string, required: job id at the time of the change
    - `date` object, required: date the comp change took effect
    - `name` string, required: person's full name (first last)
    - `workEmail` string: person's work email
    - `title` string: job title as of the change date
    - `basePay` object: annualized base pay as of the change date
    - `variablePay` object: annualized variable target pay as of the change date
    - `total` object: base + variable pay (only when both share a currency)
    - `department` object: department group as of the change date
    - `manager` object: manager (person) as of the change date
  - `next` string
  - `access` ResultsAccess[]
    - `ids` string[]
    - `allowed` AccessAction[], required
      - `action` string, required
      - `fields` string[]
      - `types` string[]

## Other responses

- `400`: bad request
- `401`: not authorized
- `404`: not found

---

[API](https://skmtc.dev/charthop/apis/charthop-api.md) - [All operations](https://skmtc.dev/charthop/apis/charthop-api/llms.txt) - [OpenAPI document](https://skmtc.dev/charthop/apis/charthop-api/revisions/9076630a0d55?raw)
