Travel Dates
This screen lets the host application collect and store travel dates for a selected coverage. The SDK validates the submitted date range and returns the updated travel-date entries for that coverage.
This screen includes:
- Form screen for adding insurance coverage to the user account.
- Coverage provider selector that lists supported insurance companies.
- Policy number field used to identify the insurance policy.
- Personal information fields.
- Personal identification number field required for coverage validation.
- Date picker for Date of birth.
- Date pickers for Travel start date and Travel end date.
- Inline validation indicators for required or incomplete fields.
- Add coverage action that submits the coverage information.
Workflow 1 – Add coverage with travel dates
- Open Add Coverage.
- Enter the required coverage and user information.
- Enter the travel start and end dates.
- Select Add coverage.
- If validation succeeds, the coverage and travel dates are saved.
Workflow 2 – Add or update travel dates after coverage is created
- Open My Coverage.
- Select Travel dates for the relevant coverage.
- Enter the travel start and end dates.
- Select Add dates.
- The Stored dates section updates and groups entries by Upcoming, Ongoing, and Past.
Validations
| Scenario | App Behavior | SDK Output |
|---|---|---|
| Travel start date is empty. | Prevents submission and highlights the field. | Returns a validation error for missing start date. |
| Travel end date is empty. | Prevents submission and highlights the field. | Returns a validation error for missing end date. |
| Start date is later than end date. | Displays an error and blocks submission. | Returns a date-range validation error. |
| Entered dates fall outside the coverage validity period. | Displays an error and blocks submission. | Returns a validation error for dates outside the coverage period. |
| New dates overlap with an existing travel period. | Displays an error and blocks submission. | Returns an overlap validation error. |
Actions
| Scenario | App Behavior | SDK Output |
|---|---|---|
| Coverage is created with travel dates. | Stores the coverage and associated travel dates. | Returns the coverage with travel-date entries. |
| A new travel-date range is added. | Saves the new date range and updates the stored list. | Returns the updated travel-date entries. |
| Stored dates panel expands. | Displays existing travel periods grouped by status. | Returns the stored date ranges. |
| Dialog closes without submission. | Returns to the previous screen without changes. | Returns no update. |
Endpoint Resources
Travel Dates
PUT
v3/travel-dates
Show Travel Date Details
Add Travel Dates Form
PUT
v3/travel-dates/add
Open form to add travel date.
Add Draft Travel Date
PATCH
v3/travel-dates/add
Validate Add form and add draft row to main screen via patch replace.
Save Travel Dates
POST
v3/travel-dates/create
Save travel dates and close.