---
title: "Get Employee"
method: GET
path: "/v1/company/{companyId}/employee/{employeeId}"
tags: ["Employee (v1)"]
---

# Get Employee

`GET /v1/company/{companyId}/employee/{employeeId}`

## Request

- Base URL: `https://dc1demogw.paylocity.com/api`
- URL: `https://dc1demogw.paylocity.com/api/v1/company/{companyId}/employee/{employeeId}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.paylocity.com/IdentityServer/connect/token` scopes: `WebLinkAPI`

Get Employee API will return employee data currently available in Paylocity Payroll/HR solution.
 
> 🚧 Maintenance Mode
> 
> _This resource version is in a limited support mode and should not be used for new integrations.  Please use the latest version._

## Path parameters

- `companyId` string, required
- `employeeId` string, required

## Headers

- `Authorization` string, required

## Response `200`

Successfully Retrieved

- EmployeeV1: Employee
  - `address1` string: Employee home 1st address line. <br />Max length: 40
  - `address2` string: Employee home 2nd address line. <br />Max length: 40
  - `benefitSetup` object: Benefit Setup
    - `benefitClass` string: Benefit Class code. Values are configured in Paylocity Payroll/HR solution Company > Setup > Benefits > Classes.<br />Max length: 30
    - `benefitClassEffectiveDate` string: Date when Benefit Class takes effect. Common formats are *MM-DD-CCYY, CCYY-MM-DD*.
    - `benefitSalary` number: Salary used to configure benefits.<br />Decimal(12,2)
    - `benefitSalaryEffectiveDate` string: Date when Benefit Salary takes effect. Common formats are *MM-DD-CCYY, CCYY-MM-DD*.
    - `doNotApplyAdministrativePeriod` boolean: Applicable only for ACA Enhanced clients and Benefit Classes with ACA Employment Type of Full Time.
    - `measureACAEligibility` boolean: Only valid for ACA Enhanced clients and Benefit Classes that are ACA Employment Type of Full Time.
  - `birthDate` string: Employee birthdate. Common formats are *MM-DD-CCYY, CCYY-MM-DD*.
  - `city` string: Employee home city. <br />Max length: 40
  - `companyNumber` string: Paylocity assigned company number. <br /> Max length: 9
  - `departmentPosition` object: Department Position
    - `costCenter1` string: Employer defined location, like *branch, division, department*, etc. Must match Company setup. <br />Max length: 10
    - `costCenter2` string: Employer defined location, like *branch, division, department*, etc. Must match Company setup. <br />Max length: 10
    - `costCenter3` string: Employer defined location, like *branch, division, department*, etc. Must match Company setup. <br />Max length: 10
    - `employeeType` string: Employee current employment type. Common values *RFT (Regular Full Time), RPT (Regular Part Time), SNL (Seasonal), TFT (Temporary Full Time), TPT (Temporary Part Time)*. <br />Max length: 10
    - `equalEmploymentOpportunityClass` string: Values are configured in Company > Setup > HR > EEO Classes.<br /> Max length: 10
    - `jobTitle` string: Employee current job title. <br />Max length: 50
    - `payGroup` string: Employee pay group. Must match Company setup. <br /> Max length: 20
  - `employeeId` string: Leave blank to have Paylocity Payroll/HR solution automatically assign the next available employee ID.<br /> Max length: 10
  - `employeeStatus` object: Employee Status
    - `employeeStatusCode` string: Employee current work status. Common values are *A* (Active), *L* (Leave of Absence), *T* (Terminated). <br />Max length: 20
  - `ethnicity` string: Employee ethnicity.<br /> Max length: 10
  - `firstName` string: Employee first name. <br />Max length: 40
  - `gender` string: Employee gender. Common values *M* (Male), *F* (Female). <br />Max length: 1
  - `highlyCompensatedEmployee` boolean: Indicates if employee meets the highly compensated employee criteria.
  - `hireDate` string: Employee hired date. Common formats are *MM-DD-CCYY, CCYY-MM-DD*.
  - `homePhone` string: Employee home phone number. <br />Max length: 12
  - `lastName` string: Employee last name. <br />Max length: 40
  - `maritalStatus` string: Employee marital status. Common values *D (Divorced), M (Married), S (Single), W (Widowed)*. <br />Max length: 10
  - `middleName` string: Employee middle name.<br /> Max length: 20
  - `nickname` string: Employee preferred display name. <br /> Max length: 20
  - `ownerPercent` number: Percentage of employee's ownership in the company, entered as a whole number . <br /> Decimal (12,2)
  - `personalEmailAddress` string: Employee personal email address. <br />Max length: 50
  - `personalMobilePhone` string: Employee personal mobile phone number. <br />Max length: 12
  - `position` string: Employee position code. Must match Company setup.<br />Max length: 20
  - `postalCode` string: Employee work zip code.<br /> Max length: 10
  - `primaryPayRate` object: Primary Pay Rate
    - `annualSalary` number: Employee annual salary. <br />Decimal (12,2)
    - `baseRate` number: Employee base rate, used for Hourly employees. <br />Decimal (12,2)
    - `defaultHours` number: Employee default hours consistently worked. If autoPayType is set to D, employee will be paid hourly base rate for the defaultHours. <br />Decimal (12,2)
    - `payFrequency` string: Employee current pay frequency. Common values are *A (Annual), B (Bi-Weekly), D (Daily), M (Monthly), S (Semi-Monthly), Q (Quarterly), W (Weekly)*. <br />Max length: 5
    - `payType` string: Employee pay type (rate code). Valid values are *Hourly* or *Salary*. <br />Max length: 10
    - `primaryPayRateEffectiveDate` string: The date the employee’s pay rate takes effect. (MM-DD-CCYY)
    - `salary` number: Employee gross salary per pay period used with payType Salary.<br />Decimal (12,2)
  - `reHireDate` string: Rehire date if employee is rehired. Common formats are *MM-DD-CCYY, CCYY-MM-DD*.
  - `ssn` string: Employee social security number. Leave it blank if valid social security number not available. <br />Max length: 11
  - `state` string: Employee home state. <br />Max length: 2
  - `statutory` boolean: Indicates if employee is statutory.
  - `supervisorCompanyNumber` string: Supervisor's company number. Defaults to employee company number.<br />Max length: 9
  - `supervisorEmployeeId` string: EmployeeId of the supervisor. <br />Max length: 10
  - `taxForm` string: Employee tax form for reporting income. Valid values are *W2, 1099M, 1099R, 1099NEC, Non-US*. Default is W2. <br />Max length: 15
  - `terminationDate` string: Date of employee termination. Common formats are *MM-DD-CCYY, CCYY-MM-DD*.
  - `terminationReason` string: Employee termination reason. Must match Company setup for employee status.<br />Max length: 15
  - `workEmailAddress` string: Employee work email. <br />Max length: 50
  - `workPhone` string: Employee work phone number.<br /> Max length: 12
  - `workPhoneExt` string: Employee work phone extension number.<br /> Max length: 10

## Other responses

- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/paylocity/apis/weblink-api.md) - [All operations](https://skmtc.dev/paylocity/apis/weblink-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paylocity/apis/weblink-api/revisions/8152ed40b412?raw)