---
title: "Retrieves a list of balances for the specified definition and optionally period."
method: POST
path: "/api/balances"
tags: ["Balances"]
---

# Retrieves a list of balances for the specified definition and optionally period.

`POST /api/balances`

## Request body

- IntectWebAPIControllersBalancesControllerBalancesRequest
  - `BalanceDefinitionId` integer
  - `VacationTypeId` integer, nullable
  - `BalancePeriodId` integer, nullable
  - `PerDate` string, date-time

## Response `200`

OK

- IntectGetBalancesEmployeeViewByDateResult[]
  - `UserEmploymentId` integer
  - `IdentityNumber` string
  - `FullName` string
  - `BalanceName` string
  - `SpecialIdentifier` string
  - `BalancePeriodId` integer, nullable
  - `PeriodIdentifier` string
  - `PeriodName` string
  - `EarningStartDate` string, date-time, nullable
  - `EarningEndDate` string, date-time, nullable
  - `SpendingStartDate` string, date-time, nullable
  - `SpendingEndDate` string, date-time, nullable
  - `BaseAmount` number, double, nullable
  - `AmountEarned` number, double, nullable
  - `AmountSpent` number, double, nullable
  - `GrossAmountSuspended` number, double, nullable
  - `AmountTotal` number, double, nullable
  - `TaxAmountTotal` number, double, nullable
  - `NetAmountTotal` number, double, nullable
  - `DaysEarned` number, double, nullable
  - `DaysSpent` number, double, nullable
  - `DaysSuspended` number, double, nullable
  - `DaysTotal` number, double, nullable
  - `HoursEarned` number, double, nullable
  - `HoursSpent` number, double, nullable
  - `HoursTotal` number, double, nullable
  - `SecondaryDaysEarned` number, double, nullable
  - `SecondaryDaysSpent` number, double, nullable
  - `CurrentBalanceSecondaryDays` number, double, nullable
  - `SecondaryAmountTotal` number, double, nullable
  - `TertiaryAmountTotal` number, double, nullable
  - `ExternalReference` string
  - `DepartmentId` integer, nullable
  - `DepartmentName` string
  - `DepartmentExternalReference` string
  - `BasedOnTemplateId` integer, nullable
  - `BasedOnTemplateName` string
  - `VacationTypeId` integer
  - `VacationProviderId` integer, nullable
  - `VacationYearStartMonth` integer, nullable
  - `DraftAmount` number, double, nullable
  - `DraftDaysSuspended` number, double, nullable

---

[API](https://skmtc.dev/intect/apis/intect-rest-api.md) · [All operations](https://skmtc.dev/intect/apis/intect-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/intect/intect-rest-api/revisions/e256dcb495d4/schema)