Skip to main content
GET
Get person
Each employments entry is a complete Employee object in a credential-authorized company, including top-level participation and coverage. Person-level demographics or statuses are not selected; those values stay within each employment. Person updatedAt does not track nested employment changes. Repeating externalIdSystems selects returned IDs from payroll_system or hhaexchange. An unsupported external ID system returns 400 invalid_input with a message naming the value. A malformed Person UUID returns 400 invalid_input; an absent or out-of-scope Person returns 404 not_found.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

personId
string<uuid>
required

Person UUID.

Query Parameters

externalIdSystems
enum<string>[]

Repeat for each system; selects which external IDs are returned.

Available options:
payroll_system,
hhaexchange

Response

Person record.

asOf
string<date-time>
required
person
object
required