---
title: "Reads a single Allowance stat"
method: GET
path: "/api/2026-07-01/resources/timeoff/allowance_stats/{id}"
tags: ["Timeoff > AllowanceStat"]
---

# Reads a single Allowance stat

`GET /api/2026-07-01/resources/timeoff/allowance_stats/{id}`

Retrieves the employee time off counters for a specific allowance with a reference date

## Path parameters

- `id` string, required

## Response `200`

OK

- TimeoffAllowanceStatsNew
  - `id` string, required — A virtual ID for the allowance stat, composed of employee_id/allowance_id/reference_date. Cannot be used to fetch this resource.
  - `allowance_id` string, required — ID of the allowance these stats belong to.
  - `employee_id` string, required — ID of the employee these stats belong to.
  - `year` integer, required — Calendar year used to scope cycle calculations.
  - `cycles` unknown[], required — Array of cycle objects describing each accrual period for the allowance.
    - unknown
  - `cycle_carry_overs` unknown[], required — Carry over entries between cycles, typed as an array of CycleCarryOver value objects.
    - unknown
  - `accumulated_carry_over` string, required — Total carried over units accumulated from previous cycles.
  - `available_days` string, required — Remaining usable allowance units at the reference date, after usage, carry-over, and incidence adjustments.
  - `total_accrued_units` string, required — Total accrued/generated allowance units up to the reference date.
  - `total` string, required — Total entitlement for the cycle used by the Total row in counters (accrued + carry over + incidences, with backend cap/rounding rules applied before incidences).
  - `incidences` string, required — Sum of incidence units (adjustments) applied to this allowance.
  - `accrued_incidences` string, required — Sum of incidence units scoped to 'accrued' target balance for the current cycle, filtered by cycle coverage rules.
  - `available_incidences` string, required — Sum of incidence units scoped to non-accrued target balances for the current cycle, filtered by cycle coverage rules.
  - `max_balance_cap` string — Maximum balance cap enforced by policy (null if unlimited or no cap).
  - `policy_allowance` string, required — Base policy entitlement for the cycle in allowance units (days or hours depending on allowance setup), before proration and adjustments.
  - `prorated_allowance_days` string, required — Allowance days after proration based on employee tenure or configuration.
  - `total_in_decimal` string — Total allowance units in decimal form (null if not computed for the reference date yet).
  - `used_carry_over` string, required — Units from carry over already consumed.
  - `used_days` string, required — Total used days (converted from units) up to the reference date.
  - `used_units_until_reference_date` string, required — Units consumed strictly until the given reference date (excludes future approved leaves).
  - `outstanding_units` string, required — Pending units scheduled (approved in the future) not yet counted as used until the reference date.

---

[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/versions/1a6bffb20f7d/schema)