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

# Reads all Compensations

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

Reads all Compensations

## Query parameters

- `ids[]` string[]
- `contract_version_ids[]` string[]

## Response `200`

OK

- object
  - `data` ContractsCompensation[]
    - `id` string, required
    - `contract_version_id` string, required
    - `contracts_taxonomy_id` string, required
    - `description` string
    - `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
    - `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
    - `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

---

[API](https://skmtc.net/factorialhr/apis/factorial-api.md) · [All operations](https://skmtc.net/factorialhr/apis/factorial-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/factorialhr/factorial-api/revisions/1a6bffb20f7d/schema)