Skip to content

Rippling: GET Employee — base Api get Employees Employee Id — response body

GET Employee — baseApi.getEmployeesEmployeeId: response body. Complete fields and constraints for contract 2026-10-28.

API reference · Contract 2026-10-28

SDK schema: GET Employee — base Api get Employees Employee Id — response body

FieldTypePresenceDescription and constraints
$objectRootAn employee model object.
customFieldsModelOptionalExpand GET Employee — base Api get Employees Employee Id — response body — custom Fields
departmentstringOptionalThe employee’s department name
employeeNumberstringOptionalThis indicates the sequential employee number within their company. This number continues to grow as each employee is onboarded. i.e if you are the 65th employee to join the company with 32 active employees, the employeeNumber would be 65.
employmentTypestringOptionalAn ENUM of employment type. Will default to one of these six values unless the employee’s profile has a job display name configured.
Known values: CONTRACTOR, SALARIED_FT, SALARIED_PT, HOURLY_FT, HOURLY_PT, TEMP
endDateJSONOptional
endDate (anyOf 1)stringAlternativeThe employee’s end date
endDate (anyOf 2)nullAlternative
firstNamestringOptionalFirst name of the employee
genderJSONOptional
gender (anyOf 1)stringAlternativeThe employee’s gender
Known values: MALE, FEMALE
gender (anyOf 2)nullAlternative
idstringOptionalThis is the unique role ID of the employee. A role ID exists per 1 and only 1 company.
identifiedGenderJSONOptional
identifiedGender (anyOf 1)stringAlternativeThe employee’s identified gender
Known values: MALE, FEMALE, NONBINARY
identifiedGender (anyOf 2)nullAlternative
isInternationalbooleanOptionalWhether the employee is an international employee or not.
isManagerbooleanOptionalWhether the employee is a manger
isRemotebooleanOptionalWhether the employee’s job is remote
lastNamestringOptionalLast name of the employee
levelstringOptionalThe level of the employee
managerJSONOptional
manager (anyOf 1)stringAlternativeThe unique identifier of the employee’s manager. This value can be null.
manager (anyOf 2)nullAlternative
namestringOptionalFull name of the employee
photostringOptionalThe photo of the employee stored in Rippling
preferredFirstNamestringOptional
preferredLastNamestringOptional
roleStatestringOptionalThe employee’s role status - roleState meanings:

INIT: An initial record of an individual. An offer has not been made and they have not started working at the company.

HIRED: An offer has been made but they have not accepted or started yet.

ACCEPTED: An offer has been made and they have accepted, but they have not started yet.

ACTIVE: The employee currently works at the company and their start date is today or in the past.

TERMINATED: The employee is no longer active.
Known values: INIT, HIRED, ACCEPTED, ACTIVE, TERMINATED
smallPhotostringOptionalThe small photo of the employee stored in Rippling
spokeIdJSONOptional
spokeId (anyOf 1)stringAlternative
spokeId (anyOf 2)nullAlternative
teamsarrayOptionalAn array of the teams that the employee is on
teams[]JSONEach item
titlestringOptionalThe employee’s work title
userIdstringOptionalThis is the unique user ID of the employee. A userID can span across 1 or many companies.
workEmailJSONOptional
workEmail (anyOf 1)stringAlternativeThe employee’s work email
workEmail (anyOf 2)nullAlternative
workLocationJSONOptional
workLocation (anyOf 1)ModelAlternativeExpand GET Current Company — base Api get Companies — response body — address An address object as stored within Rippling
workLocation (anyOf 2)nullAlternative
workScheduleobjectOptionalThe employee’s weekly work schedule
worklocationNicknamestringOptionalThe work location nickname

Referenced models: GET Employee — base Api get Employees Employee Id — response body — custom Fields, GET Current Company — base Api get Companies — response body — address An address object as stored within Rippling

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.