Skip to main content

Approve Alternative Offer

Use the Approve Alternative Offer screen to review alternative appointment offers and submit an approval or refusal decision.
This screen appears when the clinic provides one or more alternative appointment options.


This screen includes:

  • A header with back navigation and an Appointment offers title.
  • A list of appointment offer cards.
  • For each offer:
    • Doctor name and specialty.
    • Offered date and time.
    • Visit location or Video (online) indicator.
    • Appointment cost.
    • A radio selection control.
  • A primary Approve action.
  • A secondary Refuse All action.
  • A validation state when no offer is selected.

Workflow​

  1. Review the appointment offers provided by the clinic.
  2. Select one appointment offer.
  3. Select Approve to submit the selected option.

If the clinic provides one alternative, the screen applies implicit selection and enables approval.

If multiple alternatives are available, the SDK returns offers ordered by ascending appointment time.

Validations​

ScenarioApp behaviorSDK output
No appointment offer is selected.The Approve action remains disabled.Page model with disabled primary action and selection-required validation state.
An appointment offer is selected.The Approve action becomes enabled.Page model with selectedOfferId and enabled primary action.
Offer selection

Only one appointment offer can be approved.
Selecting a different offer clears the previous selection.

Actions​

ScenarioApp behaviorSDK output
Select an appointment offer.The selected offer becomes active and previous selection clears.Page model update with new selectedOfferId.
Select Approve.The appointment updates to the selected offer.Update set that applies approval and returns updated appointment state.
Select Refuse All.All offers are refused and approval becomes unavailable.Update set that applies refusal and returns updated appointment state.
Use back navigation.Navigation returns to appointment details without submitting changes.Navigation instruction with unchanged appointment state.
Refusal behavior

If you refuse all offers, the appointment remains unscheduled.
The clinic may send new alternatives or contact you for further coordination.

Endpoint Resources​

Approve Appointment Request​

PUT 

v3/appointments/{appointment-id}/approve

This endpoint applies the selected offer decision for the specified appointment and returns the updated appointment state.