Get an employee by ID
Return the full details for one employee, including their personal address — use it as the HOME shipping address when ordering equipment for a remote employee. For office addresses, use getCompanyAddresses instead. It carries the same fields as getEmployees — teams, jobs and the MDM enrollment chase fields (enrollmentReminderStatus, lastEnrollmentRequestSentAt, enrollmentReminderEnabled, documented on getEmployees) included — plus emails (every email address of the employee), address, employmentType and isRemote. email and personalEmail are deprecated: read emails.
Authorizations
Use your Primo API key in the Authorization header as Bearer <API_KEY>.
Path Parameters
Response
Deprecated — use emails on getEmployee. Primary address of the employee, derived from emails; null when they have none.
Teams the employee belongs to. Empty only when no team is assigned — group by name to count per team.
Job titles held by the employee. Empty only when no job title is assigned.
Employee groups the employee belongs to.
Null when the employee has no onboarding.
PENDING, SCHEDULED, IN_PROGRESS, CLOSED, CANCELED Null when the employee has no offboarding.
PENDING, SCHEDULED, IN_PROGRESS, CLOSED, CANCELED When the last MDM enrollment request was emailed to the employee (ISO 8601). Null if none ever was.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$Whether the built-in enrollment reminder job is allowed to re-send to this employee.
Where the employee stands in the built-in enrollment reminder cycle. See the tool description for what each value means.
NEVER_SENT, REMINDER_CYCLE_ACTIVE, REMINDER_CYCLE_STALLED, REMINDERS_DISABLED Ids of the devices assigned to the employee.
Ids of the accessories assigned to the employee.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$Every email address the employee is known by, the work and personal ones included. A new SaaS account is created with one of them: pass it as email to provisionSaasIdentity or createSaasProvisioningIntent.
Employment type of the employee
INTERNAL, CONTRACTOR Whether the employee works remotely. Derived from the absence of a work location: an employee with no assigned work location has no office to deliver equipment to and is treated as remote.
Office the employee is attached to. Null for a remote employee.
Legal entity employing them.
Id of the manager employee.
Employment start date (ISO 8601).
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$Employment end date (ISO 8601).
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$Deprecated — use emails instead. Personal address of the employee, derived from emails: the first one on none of the company's domains, other than the primary address. Null when there is none.
Personal (home) address of the employee, when known. Use it as the HOME shipping address when ordering equipment for a remote employee. Null when the employee record has no address — ask for one instead of composing it.