Skip to main content
GET
/
v4
/
appointment
/
current
Get current appointment
curl --request GET \
  --url https://api.example.com/v4/appointment/current \
  --header 'x-meetergo-api-user-id: <api-key>'
{
  "id": "<string>",
  "secret": "<string>",
  "ics": "<string>",
  "meetingInfo": {
    "name": "<string>",
    "description": "<string>",
    "enableRedirect": true,
    "redirect": "<string>",
    "duration": 123,
    "channel": "local",
    "customChannelName": "<string>",
    "customChannelLink": "<string>",
    "groupBooking": true,
    "enrichInvitee": true,
    "confirmationButton": {
      "useConfirmationButton": true,
      "text": "<string>",
      "color": "<string>",
      "link": "<string>"
    },
    "bufferBefore": 123,
    "bufferAfter": 123,
    "color": {}
  },
  "hostingInfo": {
    "mainHost": "<string>",
    "meetingLink": "<string>",
    "googleEventId": "<string>",
    "googleConnectionSub": "<string>",
    "calendarConnectionId": "<string>",
    "zoomMeetingId": 123,
    "connectChannelId": "<string>",
    "wherebyMeetingId": "<string>",
    "calendarSyncProviders": {
      "id": "<string>",
      "type": "<string>",
      "hostId": "<string>",
      "eventId": "<string>",
      "calendarId": "<string>"
    }
  },
  "cancel": {
    "actionSource": "attendee",
    "actionAt": "<string>",
    "actionBy": "<string>",
    "reason": "<string>"
  },
  "crmOptions": {
    "hubspotContactSync": true,
    "hubspotContactStage": "<string>",
    "hubspotCompanySync": true,
    "hubspotCompanyStage": "<string>",
    "hubspotCompanyMatchingField": "<string>",
    "hubspotDealSync": true,
    "hubspotDealStage": "<string>",
    "hubspotPipelineId": "<string>",
    "pipedriveDealSync": true,
    "pipedriveContactSync": true,
    "pipedrivePipelineId": 123,
    "pipedriveStageId": 123,
    "linkandoSyncEnabled": true,
    "linkandoPlaybookId": 123,
    "linkandoTemplateId": 123,
    "evalancheEnabled": true,
    "klicktippEnabled": true,
    "getResponseEnabled": true,
    "getResponseCampaignId": "<string>",
    "smartWeContactSync": true,
    "smartWeCompanySync": true,
    "smartWeDealSync": true,
    "smartWeDealStage": "<string>",
    "salesforceSyncEnabled": true,
    "salesforceCaseSync": true,
    "salesforceLeadSync": true,
    "salesforceOpportunitySync": true,
    "salesforceLeadStatus": "<string>",
    "salesforceCaseStatus": "<string>",
    "salesforceOpportunityStage": "<string>",
    "salesforceDefaultObjectType": "<string>"
  },
  "start": "<string>",
  "end": "<string>",
  "isCancelled": true,
  "attendees": [
    {
      "id": "<string>",
      "secret": "<string>",
      "email": "<string>",
      "bringalongEmails": [
        "<string>"
      ],
      "notes": {},
      "receiveReminders": true,
      "language": "<string>",
      "timezone": "<string>",
      "noShow": true,
      "dataPolicyAccepted": true,
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "fullname": "<string>",
      "firstname": "<string>",
      "lastname": "<string>",
      "phone": "<string>",
      "doubleOptIn": "<string>",
      "deletedAt": "<string>"
    }
  ],
  "attendeeIds": [
    "<string>"
  ],
  "roundRobinEntries": [
    {
      "id": 123,
      "createdAt": "<string>",
      "userId": "<string>",
      "groupId": "<string>",
      "appointmentId": "<string>",
      "queueId": "<string>",
      "selectionReason": "<string>"
    }
  ],
  "meetingTypeId": "<string>",
  "hostIds": [
    "<string>"
  ],
  "scheduledReminderIds": [
    "<string>"
  ],
  "companyId": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "resolvableErrors": [
    {
      "errorCode": "<string>"
    }
  ],
  "rescheduledAt": "<string>",
  "location": "<string>",
  "deletedAt": "<string>",
  "paymentId": "<string>",
  "note": "<string>"
}

Authorizations

x-meetergo-api-user-id
string
header
required

User ID to act as when using API Key authentication (required with API Key)

Response

200 - application/json

Current appointment retrieved successfully

id
string
required

Appointment ID

secret
string
required

Secret key for appointment authentication

ics
string
required

ICS calendar data

meetingInfo
object
required

Meeting information including title, duration, etc.

hostingInfo
object
required

Hosting information including links and integration IDs

cancel
object
required

Cancellation information

crmOptions
object
required

CRM integration options

start
string
required

Appointment start time (ISO string)

end
string
required

Appointment end time (ISO string)

isCancelled
boolean
required

Whether the appointment is cancelled

attendees
object[]
required

Appointment attendees without relation properties

attendeeIds
string[]
required

Array of attendee IDs

roundRobinEntries
object[]
required

Round robin entries for this appointment

meetingTypeId
string
required

Meeting type ID

hostIds
string[]
required

Array of host user IDs

scheduledReminderIds
string[]
required

Array of scheduled reminder IDs

companyId
string
required

Company ID this appointment belongs to

createdAt
string
required

Creation timestamp

updatedAt
string
required

Last update timestamp

resolvableErrors
object[]
required

Appointment resolvable errors (error codes only)

rescheduledAt
string

When the appointment was rescheduled

location
string

Meeting location

deletedAt
string

Soft deletion timestamp

paymentId
string

Payment ID if this is a paid appointment

note
string

Appointment note