## List member employments **get** `/v1/members/{member_id}/employments` Lists a member's employment across every employer — the same employee record shape as the employer's employees list, plus the employer name. For an organization caller the rows are scoped to companies in that organization's book; a member (self/household) or Vitable Admin sees all employments. A member not visible to the caller returns a 404. ### Path Parameters - `member_id: string` Unique member identifier (mbr_*) ### Returns - `data: array of Employee` - `id: string` Unique employee identifier with 'empl_' prefix - `classification_effective_date: string` Date the employee's current classification took effect - `compensation_type: "Salary" or "Hourly"` * `Salary` - Salary * `Hourly` - Hourly - `"Salary"` - `"Hourly"` - `compensation_type_effective_date: string` Date the employee's current compensation type took effect - `created_at: string` Timestamp when the employee was created - `date_of_birth: string` Date of birth (YYYY-MM-DD) - `deductions: array of { benefit_name, deduction_amount_in_cents, deduction_category, 4 more }` Payroll deductions from the most recent statement period. Replaced when a new statement is generated. - `benefit_name: string` Name of the benefit plan - `deduction_amount_in_cents: number` Employee deduction amount in cents - `deduction_category: string` Deduction category (reserved for future use) - `frequency: "weekly" or "bi_weekly" or "semi_monthly" or "monthly"` * `weekly` - Weekly * `bi_weekly` - Bi Weekly * `semi_monthly` - Semi Monthly * `monthly` - Monthly - `"weekly"` - `"bi_weekly"` - `"semi_monthly"` - `"monthly"` - `period_end_date: string` Period end date (YYYY-MM-DD) - `period_start_date: string` Period start date (YYYY-MM-DD) - `tax_classification: "Unknown" or "Pre-tax" or "Post-tax"` * `Unknown` - Unknown * `Pre-tax` - Pre Tax * `Post-tax` - Post Tax - `"Unknown"` - `"Pre-tax"` - `"Post-tax"` - `email: string` Email address - `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"` - `employer_id: string` Unique identifier of the employer this employment is with (empr_*) - `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 - `phone: string` Phone number (10-digit US domestic string) - `start_date: string` Employee's start date with the employer - `status: "active" or "terminated"` Employee status (active or terminated) - `"active"` - `"terminated"` - `updated_at: string` Timestamp when the employee was last updated - `address: optional { 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: optional string` Secondary street address (apt, suite, etc.) - `employer_name: optional string` Name of the employer this employment is with - `gender: optional string` Gender identity, if provided - `reference_id: optional string` Partner-assigned reference ID for the employee - `suffix: optional string` Name suffix (e.g., Jr., Sr., III) - `termination_date: optional string` Employee's termination date, if terminated ### Example ```http curl https://api.vitablehealth.com/v1/members/$MEMBER_ID/employments \ -H "Authorization: Bearer $VITABLE_CONNECT_API_KEY" ``` #### Response ```json { "data": [ { "id": "empl_abc123def456", "member_id": "mbr_abc123def456", "employer_name": "Acme Corp", "first_name": "Jane", "last_name": "Doe", "employee_class": "full_time", "status": "active", "start_date": "2024-01-15", "termination_date": null, "compensation_type": "salary" } ] } ```