---
title: "Reads all Compensations"
method: GET
path: "/api/2026-10-01/resources/contracts/compensations"
tags: ["Contracts > Compensation"]
---

# Reads all Compensations

`GET /api/2026-10-01/resources/contracts/compensations`

## Request

- Base URL: `https://api.factorialhr.com`
- URL: `https://api.factorialhr.com/api/2026-10-01/resources/contracts/compensations`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://id.factorialhr.com/oauth/authorize`
    - Token URL: `https://id.factorialhr.com/api/oauth/token` scopes: `contracts`
  - API key in header `x-api-key`

Reads all Compensations

## Query parameters

- `ids[]` string[]: Return only the compensations with these ids.
- `contract_version_ids[]` string[]: Return only the compensations belonging to these contract versions.

## Response `200`

OK

- object
  - `data` ContractsCompensation[]
    - `id` string, required: Unique identifier of the compensation
    - `contract_version_id` string, required: ID of the contract version this compensation belongs to
    - `contracts_taxonomy_id` string, required: ID of the contracts taxonomy categorising this compensation
    - `description` string: Free-text description of the compensation
    - `compensation_type` string: Required field. You can only use the following options: fixed, undefined, up_to, per_worked_day, per_worked_hour
    - `amount` integer: Value paid on each recurrence, stored in the smallest currency unit (for example cents). Required unless the compensation type is `undefined`
    - `unit` string, required: In which unit compensation is paid
    - `sync_with_supplements` boolean
    - `payroll_policy_id` string
    - `recurrence_count` integer: How much time will pass between payments. If recurrence is empty, assume months. For example, 12 here means compensation is paid yearly
    - `starts_on` string: Date from which this compensation applies
    - `recurrence` string: Frequency (monthly, yearly, one_time) to determine how often the employee is paid. Could be empty, use `recurrence_count` in that case
    - `first_payment_on` string: Date of the first payout; differs from `starts_on` when payroll scheduling or accrual rules delay payment
    - `calculation` string: Human-readable hint about the payroll formula used (for example "current period" or "average of last 3 months")
    - `currency` string: ISO 4217 currency code the amount is expressed in
    - `time_condition` 'full_day' | 'half_day' | 'custom'
    - `minimum_amount_of_hours` integer
    - `minimum_amount_of_hours_in_cents` integer: Compensation expected minimum amount of hours in cents
  - `meta` PagedIndexMeta
    - `start_cursor` string
    - `end_cursor` string
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `limit` integer, required
    - `total` integer, required

## Changes

- **2026-11-03** `83ac9aa1de50`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/factorialhr/apis/factorial-api/changes/api/2026-10-01/resources/contracts/compensations/get.md)

---

[API](https://skmtc.dev/factorialhr/apis/factorial-api.md) - [All operations](https://skmtc.dev/factorialhr/apis/factorial-api/llms.txt) - [OpenAPI document](https://skmtc.dev/factorialhr/apis/factorial-api/revisions/83ac9aa1de50?raw)