List Employment History | SalaryBox

{
  "message": "Success",
  "status": true,
  "data": [
    {
      "employment_history": [
        {
          "company_name": "Infosys Ltd",
          "designation": "HR Associate",
          "joining_date": "2019-07-01",
          "leaving_date": "2022-05-31",
          "salary": "32000.00",
          "currency": "INR",
          "company_gst": "29AABCI1681G1ZS"
        },
        {
          "company_name": "Sunrise Textiles",
          "designation": "Trainee",
          "joining_date": "2017-06-01",
          "leaving_date": "2019-06-15",
          "salary": null,
          "currency": "",
          "company_gst": ""
        }
      ],
      "salarybox_id": "SBK7Q2M9TX",
      "employee_id": "EMP-0042",
      "name": "Aarav Sharma",
      "branches": [
        "Mumbai HQ"
      ],
      "departments": [
        "Engineering"
      ]
    }
  ],
  "count": 1,
  "prev": null,
  "next": null
}

Returns staff members’ previous employers, as entered in the past employment section of their SalaryBox profile. This is their work history before your company.

Grouped by staff member: each item is one person followed by employment_history, newest joining_date first (entries with no joining_date come last). Only staff with at least one entry are listed.

Authentication

AuthorizationApi-Key

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

Query parameters

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 500.

Response

messagestring

statusboolean

datalist of objects

countinteger

Total number of matching staff members (with at least one past-employment entry) across all pages.

prevstring or null

URL of the previous page, or null on the first page.

nextstring or null

URL of the next page, or null on the last page.