---
title: "Returns a specific absence account balance"
method: GET
path: "/employees/absence-accounts/balances/{balanceId}"
tags: ["Employee absence account balances"]
---

# Returns a specific absence account balance

`GET /employees/absence-accounts/balances/{balanceId}`

## Request

- Base URL: `https://api.craftboxx.de`
- URL: `https://api.craftboxx.de/employees/absence-accounts/balances/{balanceId}`
- Auth: HTTP bearer

## Path parameters

- `balanceId` integer, required

## Response `200`

Leave balance

- object
  - `data` EmployeeAbsenceAccountBalance
    - `id` integer: ID
    - `employee_id` integer: Person
    - `employee` unknown
    - `year` integer: Year
    - `holidays_taken` number, float: Holidays taken that year
    - `holidays_entitlement` number, float: Holiday entitlement
    - `holidays_total_entitlement` number, float: Calculated holiday entitlement
    - `balance` number, float: Balance
    - `first_line` string: First line
    - `created_at` string, date-time: Created
    - `updated_at` string, date-time: Updated

## Other responses

- `401`: The request lacks valid authentication credentials.
- `403`: The token is valid but lacks the permission for this action.
- `404`: The requested resource could not be found.
- `500`: An unexpected error occurred on the server (e.g. a requested relation does not exist).

## Changes

- **2026-09-03** `60bb67970e41`: 4 info
  - added the optional property `error/display_message` to the response with the `401` status
  - added the optional property `error/display_message` to the response with the `403` status
  - added the optional property `error/display_message` to the response with the `404` status
  - added the optional property `error/display_message` to the response with the `500` status

[Operation history](https://skmtc.dev/craftboxx/apis/craftboxx-api-documentation/changes/employees/absence-accounts/balances/:balanceId/get.md)

---

[API](https://skmtc.dev/craftboxx/apis/craftboxx-api-documentation.md) - [All operations](https://skmtc.dev/craftboxx/apis/craftboxx-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/craftboxx/apis/craftboxx-api-documentation/revisions/019228f63d6e?raw)