v1

latestOpenAPI 3.1.02026-07-26549156879.0 KB

Timeoff > Allowance

Reads all Allowances

Retrieves allowances

get/api/2026-07-01/resources/timeoff/allowances

Query parameters

ids[]string[]

An array of allowance ids to look for

[
  "1",
  "2"
]

timeoff_policy_idstring

Filter allowances by Time off policy id

Example:1

Filter allowances by Time off policy id

by_overtimeboolean

Filter by only overtime allowances

Example:true

Filter by only overtime allowances

Response

Example response

{
  "data": [
    {
      "id": "1",
      "accrued_denominator_in_cents": 1000,
      "accrued_factor_in_cents": 10,
      "accrued_units_availability": "current_cycle",
      "allowance_type": "days",
      "available_days": "all_days",
      "carry_over_days": 15,
      "carry_over_units_in_cents": 1500,
      "cycle_length": 12,
      "cycle_start": "jan",
      "days_type": "working_days",
      "employee_carry_over_starting_year": 1,
      "expire_in_months": 6,
      "frequency": "yearly",
      "holiday_allowance_in_cents": 2300,
      "leave_type_ids": [
        "1",
        "2",
        "3",
        "4"
      ],
      "maximum_amount_in_cents": 2800,
      "name": "Holiday Allowance",
      "negative_counter_type": "negative_counter_disabled",
      "proration_type": "proration_enabled",
      "range_type": "working_days",
      "rounding": "half_day",
      "source_units": "base_units",
      "tenure_period_transition": "beginning_of_cycle",
      "tenure_periods": [
        {
          "id": 1,
          "period_type": "years",
          "period_length": 1,
          "adjustment_in_cents": 100,
          "max_cap_in_cents": 100,
          "time_worked_based_hours_accrued_in_cents": 100,
          "time_worked_based_per_hours_worked_in_cents": 100,
          "balance_type": "fixed_balance"
        }
      ],
      "timeoff_cycle": "jan_dec",
      "timeoff_policy_id": "1"
    }
  ]
}