cURL
curl --request GET \ --url https://api.vitablehealth.com/v1/companies/{company_id}/benefits/upcoming \ --header 'X-Partner-API-Key: <api-key>'
{ "data": [ { "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "benefit_name": "<string>", "benefit_code": "<string>", "benefit_type": "<string>", "plan_year_start": "2023-12-25", "plan_year_end": "2023-12-25", "enrollment_start": "2023-12-25", "enrollment_end": "2023-12-25", "is_active": true } ], "pagination": { "page": 123, "limit": 123, "total_count": 123, "total_pages": 123 } }
Retrieve benefit plans that will become active in future periods. Useful for open enrollment planning and preparation.
Partner API key for external integrations
Unique identifier for the company
List of upcoming company benefits
Show child attributes
Unique identifier for the benefit plan
Name of the benefit (e.g., "Individual Coverage Health Reimbursement Arrangement")
Benefit type code
Category of benefit
Start date of the plan year
End date of the plan year
Enrollment period start date
Enrollment period end date
Whether the benefit is currently active
Current page number
Number of items per page
Total number of items
Total number of pages