## Get employee `employees.retrieve(employee_id) -> EmployeeRetrieveResponse` **get** `/v1/employees/{employee_id}` Retrieves detailed information for a specific employee by ID. Returns employee details including personal information and employment status. ### Parameters - `employee_id: String` Unique employee identifier (empl_*) ### Returns - `class EmployeeRetrieveResponse` Response containing a single employee resource. - `data: Employee` - `id: String` Unique employee identifier with 'empl_' prefix - `created_at: Time` Timestamp when the employee was created - `date_of_birth: Date` Date of birth (YYYY-MM-DD) - `email: String` Email address - `enrollments: Array[{ id, status, answered_at}]` Benefit enrollments for this employee - `id: String` Unique enrollment identifier with 'enrl_' prefix - `status: EnrollmentStatus` * `pending` - Pending * `enrolled` - Enrolled * `waived` - Waived * `inactive` - Inactive - `:pending` - `:enrolled` - `:waived` - `:inactive` - `answered_at: Time` Timestamp when the enrollment decision was made - `first_name: String` Employee's legal first name - `last_name: String` Employee's legal last name - `member_id: String` Unique member identifier with 'mbr_' prefix - `status: String` Employee status (active or terminated) - `updated_at: Time` Timestamp when the employee was last updated - `address: { address_line_1, city, state, 2 more}` Employee's residential address - `address_line_1: String` Primary street address - `city: String` City name - `state: String` Two-letter state code (e.g., CA, NY) - `zipcode: String` ZIP code (5 or 9 digit) - `address_line_2: String` Secondary street address (apt, suite, etc.) - `employee_class: EmployeeClass` * `Full Time` - Full Time * `Part Time` - Part Time * `Temporary` - Temporary * `Intern` - Intern * `Seasonal` - Seasonal * `Individual Contractor` - Individual Contractor - `:"Full Time"` - `:"Part Time"` - `:Temporary` - `:Intern` - `:Seasonal` - `:"Individual Contractor"` - `gender: String` Gender identity, if provided - `hire_date: Date` Employee's hire date with the employer - `phone: String` Phone number (10-digit US domestic string) - `reference_id: String` Partner-assigned reference ID for the employee - `suffix: String` Name suffix (e.g., Jr., Sr., III) - `termination_date: Date` Employee's termination date, if terminated ### Example ```ruby require "vitable_connect" vitable_connect = VitableConnect::Client.new( api_key: "My API Key", environment: "environment_1" # defaults to "production" ) employee = vitable_connect.employees.retrieve("empl_abc123def456") puts(employee) ``` #### Response ```json { "data": { "id": "empl_abc123", "member_id": "mbr_xyz789", "reference_id": "partner-ee-001", "first_name": "John", "last_name": "Doe", "suffix": null, "email": "john.doe@example.com", "date_of_birth": "1985-06-15", "gender": null, "phone": "4155551234", "employee_class": "Full Time", "status": "active", "hire_date": "2023-01-15", "termination_date": null, "address": { "address_line_1": "456 Oak Avenue", "address_line_2": "Apt 2B", "city": "San Francisco", "state": "CA", "zipcode": "94102" }, "enrollments": [ { "id": "enrl_abc123", "status": "enrolled", "answered_at": "2023-01-20T10:00:00Z" } ], "created_at": "2023-01-15T09:00:00Z", "updated_at": "2024-06-01T14:30:00Z" } } ```