---
title: "Get employee tax declaration."
method: GET
path: "/payroll/employees/taxdeclarations"
tags: ["TaxDeclaration"]
---

# Get employee tax declaration.

`GET /payroll/employees/taxdeclarations`

Get employee tax declaration.

## Query parameters

- `employeeId` string
- `financialYear` integer

## Response `200`

OK

- APIEmployeeTaxDeclarationDtoAPIReponse
  - `data` KekaAPIModelPayrollAPIEmployeeTaxDeclarationDto
    - `id` string, nullable
    - `employeeNumber` string, nullable
    - `fullName` string, nullable
    - `email` string, nullable
    - `payGroupId` string, nullable
    - `employmentStatus` 0 | 1
    - `financialYear` integer
    - `taxRegime` 0 | 1
    - `isRegimeChangeAllowed` boolean
    - `deadlines` KekaAPIModelPayrollDeadlines
      - `taxDeclarationWindow` KekaAPIModelPayrollTaxWindow
        - `isWindowOpen` boolean
        - `endDate` string, date-time, nullable
      - `taxSubmissionWindow` KekaAPIModelPayrollTaxWindow
        - `isWindowOpen` boolean
        - `endDate` string, date-time, nullable
      - `taxProofSubmissionWindow` KekaAPIModelPayrollTaxWindow
        - `isWindowOpen` boolean
        - `endDate` string, date-time, nullable
    - `taxGroups` KekaAPIModelPayrollTaxGroup[], nullable
      - `name` string, nullable
      - `title` string, nullable
      - `description` string, nullable
      - `sections` KekaAPIModelPayrollAPITaxSectionDto[], nullable
        - `name` string, nullable
        - `deductions` KekaAPIModelPayrollAPITaxDeductionDto[], nullable
          - `componentName` string, nullable
          - `componentSection` string, nullable
          - `componentTitle` string, nullable
          - `declaredAmount` number, double, nullable
          - `acceptedAmount` number, double, nullable
          - `attachments` KekaAPIModelCoreHRDocumentAttachmentDto[], nullable
            - `id` string, nullable
            - `name` string, nullable
          - `readOnly` boolean
          - `maxLimit` number, double, nullable
          - `status` 0 | 1 | 2 | 3 | 4
          - `comment` string, nullable
        - `maxLimit` number, double, nullable
      - `maxLimit` number, double, nullable
    - `allowances` KekaAPIModelPayrollAPITaxDeductionDto[], nullable
      - `componentName` string, nullable
      - `componentSection` string, nullable
      - `componentTitle` string, nullable
      - `declaredAmount` number, double, nullable
      - `acceptedAmount` number, double, nullable
      - `attachments` KekaAPIModelCoreHRDocumentAttachmentDto[], nullable
        - `id` string, nullable
        - `name` string, nullable
      - `readOnly` boolean
      - `maxLimit` number, double, nullable
      - `status` 0 | 1 | 2 | 3 | 4
      - `comment` string, nullable
    - `rentedResidences` KekaAPIModelPayrollAPIRentalHousePropertyDto[], nullable
      - `houseIdentifier` string, nullable
      - `rentPaid` number, double
      - `address` string, nullable
      - `city` string, nullable
      - `landlords` KekaAPIModelPayrollLandlordDetails[], nullable
        - `name` string, nullable
        - `address` string, nullable
        - `pan` string, nullable
        - `isVerified` boolean
        - `signedDeclaration` KekaAPIModelPayrollAttachmentDetails
          - `attachmentId` string, nullable
          - `attachmentUrl` string, nullable
        - `isSameAddress` boolean
        - `hasPan` boolean
        - `ownerType` string, nullable
      - `attachmentDetails` KekaAPIModelPayrollAttachmentDetails[], nullable
        - `attachmentId` string, nullable
        - `attachmentUrl` string, nullable
      - `status` integer
      - `from` string, date-time
      - `to` string, date-time
    - `ownedResidences` KekaAPIModelPayrollAPIOwnedHousePropertyDto[], nullable
      - `details` KekaAPIModelPayrollAPIOwnedPropertyDetailsDto
        - `id` string, nullable
        - `occupancyType` 0 | 1 | 2 | 3
        - `status` 0 | 1 | 2 | 3 | 4
        - `address` string, nullable
        - `netAnnualRentRecieved` number, double
        - `rentDetails` KekaAPIModelPayrollRentalDetails
          - `annualLettableValue` number, double
          - `municipalTaxesPaid` number, double
          - `unrealizedRent` number, double
      - `lenderDetails` KekaAPIModelPayrollLenderDetails
        - `lenderName` string, nullable
        - `lenderPan` string, nullable
        - `loanDetails` KekaAPIModelPayrollLoanDetails
          - `interestPaidByEmployee` boolean
          - `loanInterestAmount` number, double, nullable
          - `purposeOfLoan` string, nullable
      - `attachmentDetails` KekaAPIModelPayrollAttachmentDetails[], nullable
        - `attachmentId` string, nullable
        - `attachmentUrl` string, nullable
    - `incomeFromOtherSources` KekaAPIModelPayrollAPIIncomeFromOtherSourcesDto
      - `status` 0 | 1 | 2 | 3 | 4
      - `incomeFromOtherSources` KekaAPIModelPayrollAPIOtherIncomeDetailsDto
        - `netInterestReceived` number, double
        - `commissionIncome` number, double
        - `otherProfessionalIncome` number, double
        - `totalIncomeFromOtherSources` number, double
      - `tdsTcsOutsideSalary` KekaAPIModelPayrollAPITdsTcsOutsideSalaryDto
        - `tdsDeductedOnOtherIncome` number, double
        - `tcsCollectedOnHighValueTransactions` number, double
        - `totalTaxOutsideSalary` number, double
      - `attachmentDetails` KekaAPIModelPayrollAttachmentDetails[], nullable
        - `attachmentId` string, nullable
        - `attachmentUrl` string, nullable
    - `lastModified` string, date-time
  - `message` string, nullable
  - `errors` string[], nullable

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/keka/apis/keka-api.md) · [All operations](https://skmtc.net/keka/apis/keka-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keka/keka-api/revisions/907ea395c885/schema)