List Tax Declarations | SalaryBox

{
  "message": "Success",
  "status": true,
  "data": [
    {
      "financial_year": 2026,
      "declarations": [
        {
          "category": "exemption",
          "section": "HRA",
          "declared_amount": "300000.00",
          "status": "ACCEPTED",
          "submitted_on": "2026-06-12T18:30:44+05:30",
          "approved_amount": "300000.00",
          "period_start": "2026-04-01",
          "period_end": "2027-03-31",
          "admin_remark": "Rent receipts verified",
          "comments": "Rented flat in Andheri",
          "details": {
            "city_type": "metro",
            "landlord_name": "Suresh Mehta",
            "number_of_months": "12"
          }
        },
        {
          "category": "section_80_deduction",
          "section": "80C",
          "declared_amount": "150000.00",
          "status": "PENDING",
          "submitted_on": "2026-06-14T10:05:09+05:30",
          "approved_amount": null,
          "period_start": null,
          "period_end": null,
          "admin_remark": null,
          "comments": null,
          "details": {}
        }
      ],
      "salarybox_id": "SBK7Q2M9TX",
      "employee_id": "EMP-0042",
      "name": "Aarav Sharma",
      "branches": [
        "Mumbai HQ"
      ],
      "departments": [
        "Engineering"
      ]
    },
    {
      "financial_year": 2026,
      "declarations": [],
      "salarybox_id": "SBK3H8D1LP",
      "employee_id": "EMP-0057",
      "name": "Priya Nair",
      "branches": [
        "Bengaluru"
      ],
      "departments": [
        "Sales"
      ]
    }
  ],
  "count": 2,
  "prev": null,
  "next": null
}

Returns the income-tax investment and exemption declarations staff submitted for a financial year, with their approval status. Proof documents are not included. Requires Payroll Pro. Includes inactive staff; staff with no declarations are listed with an empty list.

Only ACCEPTED declarations reduce TDS. The submission deadline is in Get Payroll Settings.

Authentication

AuthorizationApi-Key

Format: “Api-Key {api-key}”

Query parameters

financial_yearintegerOptional

Year the financial year starts in: 2026 means April 2026 to March 2027. Defaults to the current financial year.

salarybox_idslist of stringsOptional

Repeatable. Limits the result to these staff members, for example salarybox_ids=SBK7Q2M9TX&salarybox_ids=SBK3H8D1LP.

pageintegerOptional

Page number, starting at 1.

page_sizeintegerOptional

Results per page. Default and maximum 50.

Response

The tax declarations for the financial year.

messagestring

statusboolean

datalist of objects

countinteger

prevstring or null

nextstring or null

Errors

400

Bad Request Error

403

Forbidden Error