Appointment Phases
Appointment Phases define the workflow stages for Appointments. Use this endpoint to query the available phases and their IDs, which are needed to update the phase of a appointment.
Use the Datastore_Phase_ActivityAppointment endpoint to query phases for this activity type.
Endpoints
List Appointment Phases
GET
/v1/odata/Datastore_Phase_ActivityAppointmentSingle Phase
GET
/v1/odata/Datastore_Phase_ActivityAppointment({id})Fields
Inherited Fields (from Phase)
See Phase Fields for all inherited fields including Name, Code, Icon, ActionName, IsAssignable, and IsTerminal.
Relationships
| Relationship | Target Entity | Cardinality | Description |
|---|---|---|---|
| Appointment | Activity_Appointment | 1:N | Appointment |
Expanding Relationships
GET
/v1/odata/Datastore_Phase_ActivityAppointment({id})?$expand=AppointmentNavigating Relationships
GET
/v1/odata/Datastore_Phase_ActivityAppointment({id})/AppointmentUsage
Query Available Phases
GET
/v1/odata/Datastore_Phase_ActivityAppointment?$select=Name,Code,IsTerminalUpdate Phase on Appointment
POST
/v1/odata/Activity_AppointmentFiltering Examples
GET
/v1/odata/Datastore_Phase_ActivityAppointment?$filter=Name eq '{Name}'&$top={top}GET
/v1/odata/Datastore_Phase_ActivityAppointment?$filter=Code eq '{Code}'&$top={top}GET
/v1/odata/Datastore_Phase_ActivityAppointment?$filter=IsTerminal eq {IsTerminal}&$top={top}GET
/v1/odata/Datastore_Phase_ActivityAppointment?$filter=IsAssignable eq {IsAssignable}&$top={top}GET
/v1/odata/Datastore_Phase_ActivityAppointment?$filter=IsDefault eq {IsDefault}&$top={top}Custom Query
Build your own OData query against Datastore_Phase_ActivityAppointment. Open Run and edit the whole request inline — swap the entity set, change the $filter, or add $expand, $select, $orderby, $top, $skip. Type $ for suggestions; use ↺ Reset to restore this example.
GET
/v1/odata/Datastore_Phase_ActivityAppointment?$top=10