Skip to main content
GET
/
api
/
v2
/
salary_details
/
{employee_id}
/
Get Employee Salary Details
curl --request GET \
  --url https://{env}.tartanhq.com/api/v2/salary_details/{employee_id}/ \
  --header 'Authorization: <api-key>'
{
  "requestId": "99ced2d1-c1e6-480a-8a00-1723ec968377",
  "message": "Salary data points successfully fetched",
  "data": {
    "ctc": {
      "dearnessAllowance": 123,
      "gratuity": 123,
      "medicalAllowance": 123,
      "travelAllowance": 123,
      "specialAllowance": 123,
      "flexiBasketAllowance": 123,
      "bonus": {
        "joining": 123,
        "referral": 123,
        "retention": 123,
        "performance": 123,
        "relocation": 123,
        "misc": 123
      },
      "deductions": {
        "pf": 123,
        "esi": 123,
        "professionalTax": 123,
        "labourWelfareFund": 123,
        "misc": 123
      }
    },
    "monthly": [
      {
        "month": 123,
        "year": 123,
        "basic": 123,
        "dearnessAllowance": 123,
        "hra": 123,
        "medicalAllowance": 123,
        "travelAllowance": 123,
        "specialAllowance": 123,
        "flexiBasketAllowance": 123,
        "gratuity": 123,
        "otherAllowance": 123,
        "deductions": {
          "pf": 123,
          "esi": 123,
          "professionalTax": 123,
          "labourWelfareFund": 123,
          "tds": 123,
          "medicalClaimDeduction": 123,
          "groupTermInsuranceDeductions": 123,
          "earlyWageDeduction": 123,
          "misc": 123
        },
        "bonus": {
          "joining": 123,
          "referral": 123,
          "retention": 123,
          "performance": 123,
          "relocation": 123,
          "misc": 123
        },
        "grossPay": 123,
        "Reimbursements": 123
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Path Parameters

​
employee_id
string
required

Unique employee ID

Query Parameters

​
org
string<uuid>
required

Organization UUID

​
vendor_org
string<uuid>
required

Vendor Organization UUID

​
type
enum<string>
required

Type of salary details to fetch

Available options:
ctc,
monthly,
ctc_monthly
​
from_date
string

Filter salaries from month-year (format MM-YYYY)

​
to_date
string

Filter salaries up to month-year (format MM-YYYY)

Response

Salary data retrieved successfully

​
requestId
string
Example:

"99ced2d1-c1e6-480a-8a00-1723ec968377"

​
message
string
Example:

"Salary data points successfully fetched"

​
data
object