Get Employee By Id
Header Parameters
Optional correlation ID for distributed tracing.
Query Parameters
Optional sub-resources to include in the response. Repeat the parameter to request multiple values (e.g. ?expand=PHONE_NUMBERS&expand=VERSIONS). Allowed values: PHONE_NUMBERS, VERSIONS.
Show child attributes
Path Parameters
Employee record external identifier (UUID v4).
Response
OK – Employee record found
Response Attributes
Unique identifier for the employee record (UUID v4).
Unique employee number within the employer.
Employee's first name.
Employee's last name.
Employee's middle name.
Employee's email address.
Date of birth (YYYY-MM-DD). Direct identifier — handled as restricted data.
US Social Security Number. Direct identifier — handled as restricted data.
Self-reported gender of the employee.
Employment information for an employee.
Show child attributes
Employee postal addresses. Always present; may be an empty array when no addresses are on file. When one or more entries are present, at most one entry per type (HOME, WORK, MAILING), and at most one entry is flagged as is_primary: true.
Show child attributes
Partner identifier for cross-domain lookups.
Employer identifier for cross-domain lookups.
Monotonically increasing version used for optimistic concurrency control on PUT/PATCH. Always returned.
Employee phone numbers. Returned only when the request specifies expand=PHONE_NUMBERS; otherwise, this property is omitted. When returned, the value is an array and may be empty.
Show child attributes
Bad Request – Validation failed. The errors map keys mirror the snake_case JSON property names used in the request payload.
Response Attributes
List of invalid parameters that caused the validation error.
Show child attributes
Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.
Show child attributes
Field-level validation errors keyed by field name. Each key maps to one or more structured error details.
Unauthorized – Missing or invalid credentials.
Response Attributes
List of invalid parameters that caused the validation error.
Show child attributes
Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.
Field-level validation errors keyed by field name. Each key maps to one or more structured error details.
Forbidden – Insufficient permissions.
Response Attributes
List of invalid parameters that caused the validation error.
Show child attributes
Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.
Field-level validation errors keyed by field name. Each key maps to one or more structured error details.
Not Found – Employee record does not exist.
Response Attributes
List of invalid parameters that caused the validation error.
Show child attributes
Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.
Field-level validation errors keyed by field name. Each key maps to one or more structured error details.
Internal Server Error.
Response Attributes
List of invalid parameters that caused the validation error.
Show child attributes
Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.
Field-level validation errors keyed by field name. Each key maps to one or more structured error details.
Internal Server Error.
Response Attributes
List of invalid parameters that caused the validation error.
Show child attributes
Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.
Field-level validation errors keyed by field name. Each key maps to one or more structured error details.