> For the complete documentation index, see [llms.txt](https://docs.suggestic.com/graphql/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.suggestic.com/graphql/query/queries/appointments/upcoming-appointments.md). # 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 This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.suggestic.com/graphql/query/queries/appointments/upcoming-appointments.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.