--- title: "Appointments.get" method: GET path: "/entities/Appointments/{id}" tags: ["Activity"] --- # Appointments.get `GET /entities/Appointments/{id}` Returns Appointment with given id ## Path parameters - `id` string, uuid, required ## Response `200` Appointment data - object - `success` boolean — True when response succeeded, false on error. - `data` Appointment - `is_delete_protected` boolean, required — Tells if the entity instance is protected against delete (Entities that need to be present in the system at any time). Delete action still may fail if entity is deletable, due some other additional validations. - `id` string, uuid, required — Unique identifier of entity. - `active_reminder` string, date-time — Timestamp of the next pending reminder configured for the activity (reminder time, due date or end date as applicable). Empty when no reminder is pending. - `media_transcription_id` string, uuid — Id of the linked Media record holding the activity's call recording / transcription, when available. - `is_deleted` boolean — Specifies if the entity is considered deleted. - `modified` string, date-time — Last modification time. - `created` string, date-time — Creation time. - `activity_type` string, uri, required — Appointment type that classifies this appointment. Drives form layout and icon. Relation to AppointmentType. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'AppointmentType' object for properties. - `currency_exchange_rates_list` string, uri — Currency exchange rate list used to convert monetary fields linked to this appointment. Empty to inherit the team space default. Relation to CurrencyExchangeRatesList. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'CurrencyExchangeRatesList' object for properties. - `owner` string, uri, required — Sales user who owns this appointment. Relation to Client. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Client' object for properties. - `recurrence_master` string, uri — Master appointment of the recurring series this occurrence belongs to. Empty for standalone appointments and for the master itself. Relation to Appointment. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Appointment' object for properties. - `schedule` string, uri — Appointment schedule (booking link) this appointment was created through, or empty for appointments created directly. Relation to AppointmentSchedule. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'AppointmentSchedule' object for properties. - `unit` string, uri, required — Sales unit this appointment is assigned to. Determines which team members can see the record under unit-based sharing. Relation to SalesUnit. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'SalesUnit' object for properties. - `activity_type_id` string, uuid — Id of the appointment type. - `currency_exchange_rates_list_id` string, uuid — Id of the currency exchange rate list applied to this appointment. - `description` string — Free-form description of the appointment. - `duration` number, double — Duration of the appointment, derived from start/end dates. - `end_date` string, date-time, required — End timestamp of the appointment. - `invitees_can_edit` boolean — True when invitees are allowed to edit the appointment. Defaults to false. - `is_recurrence_active` boolean — True when the recurrence series is still generating new occurrences. Read-only. - `is_recurrence_exception` boolean — True when this occurrence has been modified independently of the recurring series. Read-only. - `location` string — Free-text physical location of the appointment. - `meeting_url` object — Online meeting link associated with the appointment (join URL plus meeting type, e.g. Zoom, Teams). Empty when the appointment has no online meeting attached. - `occurence_date` string, date-time — Original date of this occurrence in the recurring series. Set automatically. - `organizer` string — Email of the user organising the appointment. Set automatically and used as the reply-to address in invitation emails. - `owner_id` string, uuid, required — Id of the appointment owner. - `recurrence_master_id` string, uuid — Id of the master appointment. - `recurrence_rule` string — iCalendar RRULE string describing the recurrence pattern (e.g. "FREQ=WEEKLY;BYDAY=MO,WE"). Empty for non-recurring appointments. - `recurrence_tzid` string — IANA timezone the recurrence rule is evaluated in. - `schedule_id` string, uuid — Id of the appointment schedule. - `schedule_tzid` string — IANA timezone the appointment was booked in (e.g. "Europe/Bratislava"). Used to evaluate availability against the schedule. - `start_date` string, date-time — Start timestamp of the appointment. - `subject` string, required — Short summary line shown in calendars and lists. - `table_name` string, required — Discriminator identifying the concrete record type — always "appointment" for Appointment records. Read-only; useful when consuming polymorphic Activity results. - `unit_id` string, uuid — Id of the sales unit. - `revision` integer — Revision when entity was lastly changed. - `status` 1 | 2 | 3 | 4 | 5 | 6, required — Current status of the appointment (NotStarted, InProgress, Completed, Canceled). Read-only; derived from the start/end times and the deleted flag. Integer enum value: 1 - NotStarted, 2 - InProgress, 3 - Waiting, 4 - Completed, 5 - Deferred, 6 - Canceled - `account_relations` string[] — Accounts this appointment is linked to. - `contact_relations` string[] — Contacts this appointment is linked to. - `lead_relations` string[] — Leads this appointment is linked to. - `opportunity_relations` string[] — Opportunities this appointment is linked to. - `project_relations` string[] — Projects this appointment is linked to, including the per-objective ordering. - `quote_relations` string[] — Quotes this appointment is linked to. - `custom_entity_relations` string[] — Custom entity records this appointment is linked to. - `invitees_contacts` string[] — Non-user invitees on this appointment, identified by email. Contacts are auto-linked when their email matches an existing Contact record. - `invitees_clients` string[] — Internal-user invitees on this appointment. - `exchange_entity_id` string — External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine. - `gapi_entity_id` string — External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine. - `o365_entity_id` string — External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine. - `has_3rd_party_mapping` boolean, required — True when this appointment is mirrored to an external calendar (Office 365, Exchange, Google). Read-only. - `reminder` string, uri — Reminder set by the current authenticated user for this appointment. Per-user; empty when no reminder has been set. Relation to AppointmentReminder. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'AppointmentReminder' object for properties. - `documents` string[] — Documents linked to this appointment. - `comments` string[] — Comments authored on this appointment. - `tags` string[] — Tag labels applied to this appointment. - `formatted_name` string, required — Display name of the appointment (alias of subject). - `recurrence` object — Recurrence configuration for recurring appointments (parsed RRULE plus exception metadata). Empty for one-off appointments. - `modified_by_user` string, date-time — Timestamp of the most recent modification made by an end user (excluding system changes). Read-only; computed by Coevera. ## Other responses - `404` — Sent when invalid ID is given - `500` — unexpected error --- [API](https://skmtc.net/aws/apis/pipeliner-cloud-api.md) · [All operations](https://skmtc.net/aws/apis/pipeliner-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/pipeliner-cloud-api/versions/e8c12ae60aca/schema)