---
title: "Reads a single Compensation"
method: GET
path: "/api/2026-10-01/resources/contracts/compensations/{id}"
tags: ["Contracts > Compensation"]
---

# Reads a single Compensation

`GET /api/2026-10-01/resources/contracts/compensations/{id}`

## Request

- Base URL: `https://api.factorialhr.com`
- URL: `https://api.factorialhr.com/api/2026-10-01/resources/contracts/compensations/{id}`
- 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 a single Compensation

## Path parameters

- `id` string, required

## Response `200`

OK

- 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

## 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/:id/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)