Fetch Employee CTC | SalaryBox

{
  "data": [
    {
      "salarybox_id": "EMP001",
      "employee_id": "CMP-001",
      "name": "Jane Doe",
      "branches": [
        "HQ"
      ],
      "departments": [
        "Engineering"
      ],
      "pay_cycle_type": "monthly",
      "ctc_amount": "600000.00",
      "basic_amount": "300000.00",
      "fixed_allowances_amount": "150000.00",
      "employer_pf": {
        "is_applicable": true,
        "preference": "fixed",
        "percentage": 12,
        "amount": null
      },
      "employer_esi": {
        "is_applicable": false,
        "preference": null,
        "percentage": null,
        "amount": null
      },
      "from_date": "2026-01-01"
    }
  ],
  "message": "Success",
  "status": true,
  "count": 40,
  "prev": null,
  "next": "https://.../fetch-employee-ctc?page=2"
}

Returns each employee’s payroll (CTC) configuration as of the first day of the given month. Requires an active Payroll Pro entitlement.

Authentication

AuthorizationApi-Key

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

Query parameters

salarybox_idslist of stringsOptional

Repeatable. Filters to specific employees.

monthstringOptional

Month (YYYY-MM). Defaults to the current month.

pageintegerOptional

Page number to fetch. Defaults to 1.

page_sizeintegerOptional

Number of results per page (max 500). Defaults to 25.

Response

datalist of objects

messagestring

statusboolean

countinteger

prevstring or null

nextstring or null

$	curl https://api.salaryboxapp.com/v2/customer/v1/payroll/fetch-employee-ctc \
>	-H "Authorization: Api-Key <apiKey>"