# Upcoming Appointments Use the `upcomingAppointments` query to retrieve the list of coming appointments assigned for a user. ### Arguments | Argument | Type | Description | | -------- | ------ | ------------------------------------------------------------------------------------------------------ | | `first` | Int | Retrieves the first results from the list. | | `last` | Int | Retrieves the last results from the list. | | `after` | String | See [pagination](https://docs.suggestic.com/graphql/start-here/tutorials-and-walkthroughs/pagination). | | `before` | String | See [pagination](https://docs.suggestic.com/graphql/start-here/tutorials-and-walkthroughs/pagination). | ### Available Fields

Field	Type	Description
Field	Type	Description
`id`	ID	A base64-encoded version of the `databaseId`
`appointmentCredits`	AppointmentCredit	Appointment credit.
`appointmentType`	AppointmentType!	Appointment Type.
`attendees`	string	Users attending to the appointment.
`coach`	string	Coaching portal Coach.
`contactType`	CalendarContactType!	enum: GOOGLE_MEET, PHONE_CALL, VIDEO_CALL, ZOOM
`description`	String	Description of the appointment.
`end`	DateTime!	Date and time when the appointment will end. `YYYY-MM-DDT hh:mm:ss`
`labTestReports`	LabTestReportConnection	Lab test report assigned to the appointment.
`postEventStatus`	PostEventStatus	enum: CANCELED_BY_COACH, CANCELED_BY_MEMBER, COACH_NO_SHOW COMPLETED, MEMBER_NO_SHOW, RESCHEDULED_BY_ADMIN, RESCHEDULED_BY_COACH, RESCHEDULED_BY_MEMBER, SCHEDULED
`start`	DateTime!	Date and time when the appointment will start. `YYYY-MM-DDT hh:mm:ss`
`status`	EventStatus!	enum: CANCELLED, CONFIRMED, TENTATIVE, UNKNOW
`title`	String!	Title of the appointment.
`zoomSessionName`	String	Zoom session name.
`ZoomSessionPassword`	String	Zoom session password.

## Example {% tabs %} {% tab title="Request" %}

query {upcomingAppointments 
{
  edges{
    node{
      title
      start
      end
      id
      coach{
        name
      }
    }
  }
}
}

{% endtab %} {% tab title="Response" %} ```graphql { "data": { "upcomingAppointments": { "edges": [ { "node": { "title": "Test qa", "start": "2024-02-01T19:30:00+00:00", "end": "2024-02-01T20:00:00+00:00", "id": "QXBwb2ludG1lbnQ6MjA4NDQ=", "coach": { "name": "Suggestic Admin Coach" } } } ] } } } ``` {% endtab %} {% endtabs %} ## Building Appointment URL We do not provide the appointment URL as field, instead we build the link directly on the app which can be done by using below link and replacing the fields `zoomSessionName` , `zoomSessionPassword` and `displayName` with the data gathared from the query `upcomingAppointments` as below: {% tabs %} {% tab title="First Tab" %} ```graphql query {upcomingAppointments { edges{ node{ id start zoomSessionName zoomSessionPassword attendees{ displayName } } } } } ``` {% endtab %} {% tab title="Second Tab" %} ```graphql { "data": { "upcomingAppointments": { "edges": [ { "node": { "id": "QXBwb2ludG1lbnQ6MjcxNDA=", "start": "2024-06-06T00:00:00+00:00", "zoomSessionName": "QltDAwXugsP0jE16fM0mSM69RMDOlEpwtHaBSuXbIwYg5USSZ1ivbK2NH2L", "zoomSessionPassword": "GuH5QrNtlo", "attendees": [ { "displayName": "User" } ] } } ] } } } ``` {% endtab %} {% endtabs %} **URL Template:** ```javascript https://coaching.suggestic.com/calls/join?topic=[zoomSessionName]&password=[zoomSessionPassword]&userName=[user/coach name] ``` **End Result:** ```javascript https://coaching.suggestic.com/calls/join?topic=QltDAwXugsP0jE16fM0mSM69RMDOlEpwtHaBSuXbIwYg5USSZ1ivbK2NH2L&password=GuH5QrNtlo&userName=User ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.suggestic.com/graphql/query/queries/appointments/upcoming-appointments.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.