Get appointments

GET /appointments

Get appointments with filtering

Headers

Query parameters

  • id array[string]

    ID(s) to be considered for filtering

    At least 1 element. Minimum length of each is 1.

  • external-id array[string]

    External ID(s) to be considered for filtering

    At least 1 element. Minimum length of each is 1, maximum length of each is 255.

  • from string(date-time)

    Start date and time of the appointment to be considered for filtering (ISO 8601)

    Minimum length is 1.

  • to string(date-time)

    End date and time of the appointment to be considered for filtering (ISO 8601)

    Minimum length is 1.

  • meeting-type array[string]

    Meeting type(s) to be considered for filtering

    At least 1 element. Values are OFFICE, ON_LOCATION, PHONE, or VIDEO.

  • status array[string]

    Status(es) to be considered for filtering

    At least 1 element. Values are ACCEPTED, ALTERNATIVE_DATE_REQUESTED, CANCELLED, COMPLETED, INCOMING_REQUEST, NO_SHOW, or OUTGOING_INVITE.

  • callback-request-id array[string]

    Callback request ID(s) to be considered for filtering

    At least 1 element. Minimum length of each is 1.

  • listing-id array[string]

    Listing ID(s) to be considered for filtering

    At least 1 element. Minimum length of each is 1.

  • lead-segment-id array[string]

    Lead segment ID(s) to be considered for filtering

    At least 1 element. Minimum length of each is 1.

  • subject-id array[string]

    Subject ID(s) to be considered for filtering

    At least 1 element. Minimum length of each is 1.

  • office-id array[string]

    Office ID(s) to be considered for filtering

    At least 1 element. Minimum length of each is 1.

  • customer-id array[string]

    Customer ID(s) to be considered for filtering

    At least 1 element. Minimum length of each is 1.

  • employee-id array[string]

    Employee ID(s) to be considered for filtering

    At least 1 element. Minimum length of each is 1.

  • offset string(positive-integer)

    Offset for the results to be returned

    Default value is 0.

  • limit string(positive-integer)

    Limitation for the number of results to be returned

    Default value is 25.

Responses

GET /appointments
curl \
 -X GET https://api.development.pexipengage.com/enterprises/acme/appointments \
 -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c" \
 -H "X-Correlation-Id: a4f0048e-c983-11ed-afa1-0242ac120002" \
 -H "Accept-Language: en *"
Response examples (200)
{
  "data": [
    {
      "id": "123",
      "externalId": "ABCD1234",
      "start": "2022-08-17T09:00:00.000Z",
      "end": "2022-08-17T10:00:00.000Z",
      "subject": {
        "id": "123"
      },
      "office": {
        "id": "123"
      },
      "appointmentParticipants": [
        {
          "role": "PRIMARY",
          "participant": {
            "id": "string"
          },
          "type": "EMPLOYEE",
          "videoUrl": "https://wwww.example.net/abc123",
          "videoTestUrl": "https://wwww.example.net/abc123"
        }
      ],
      "answers": [
        {
          "value": "A colleague",
          "selectedAnswerOptions": [
            {
              "id": "123"
            }
          ],
          "id": "123",
          "form": {
            "id": "123"
          },
          "question": {
            "id": "123"
          },
          "answerType": "SUBJECT_QUESTIONNAIRE",
          "createdAt": "2022-08-17T19:05:21.362Z",
          "updatedAt": "2022-08-17T19:05:21.362Z"
        }
      ],
      "callbackRequest": {
        "id": "123"
      },
      "listing": {
        "id": "123"
      },
      "leadSegment": {
        "id": "123"
      },
      "meetingType": "OFFICE",
      "status": "ACCEPTED",
      "hybrid": true,
      "trailingBufferTime": 5,
      "internalNotes": "Lorem ipsum",
      "createdAt": "2022-08-17T19:05:21.362Z",
      "createdBy": {
        "id": "123"
      },
      "createdByType": "EMPLOYEE",
      "createdFrom": "BACKOFFICE_APP",
      "updatedAt": "2022-08-17T19:05:21.362Z",
      "updatedBy": {
        "id": "123"
      },
      "updatedByType": "EMPLOYEE",
      "updatedFrom": "BACKOFFICE_APP",
      "location": {
        "city": {
          "language": "en",
          "value": "Lorem ipsum"
        },
        "state": {
          "language": "en",
          "value": "Lorem ipsum"
        },
        "street1": {
          "language": "en",
          "value": "Lorem ipsum"
        },
        "street2": {
          "language": "en",
          "value": "Lorem ipsum"
        },
        "postalCode": "9000",
        "countryCode": "BE",
        "formattedAddress": "string",
        "geolocation": {
          "latitude": 51.0479466,
          "longitude": 3.6912248
        }
      }
    }
  ],
  "meta": {
    "offset": 0,
    "limit": 25,
    "totalCount": 42
  }
}