Pexip Engage API documentation

Get schedulable offices

GET /schedulable/offices

Get schedulable offices with filtering

Headers

Authorization string

Bearer token used for authorization

Minimum length is 1.
X-Correlation-Id string

Unique identifier to allow referencing a particular transaction or event chain

Minimum length is 1.
Accept-Language string

Returns the requested resources translated according to the passed languages (see translatable resources)

Minimum length is 1.

Query parameters

employee-id array[string]

Employee ID(s) to be considered for filtering

At least 1 element. Minimum length of each is 1.
employee-external-id array[string]

Employee external ID(s) to be considered for filtering

At least 1 element. Minimum length of each is 1, maximum length of each is 255.
lead-segment-id string

Lead segment ID to be considered for filtering

Minimum length is 1.
lead-segment-code string

Lead segment code to be considered for filtering

Minimum length is 1, maximum length is 255.
listing-id string

Listing ID to be considered for filtering

Minimum length is 1.
listing-external-id string

Listing external ID to be considered for filtering

Minimum length is 1, maximum length is 255.
location object
Hide location attributes Show location attributes
- latitude number
  
  Minimum value is -90, maximum value is 90.
- longitude number
  
  Minimum value is -180, maximum value is 180.
- Additional properties are NOT allowed
meeting-type array[string]

Meeting type(s) to be considered for filtering

Values are OFFICE, ON_LOCATION, PHONE, or VIDEO.
office-id array[string]

Office ID(s) to be considered for filtering

At least 1 element. Minimum length of each is 1.
office-external-id array[string]

Office external ID(s) to be considered for filtering

At least 1 element. Minimum length of each is 1, maximum length of each is 255.
order-by-distance-to object
Hide order-by-distance-to attributes Show order-by-distance-to attributes
- latitude number
  
  Minimum value is -90, maximum value is 90.
- longitude number
  
  Minimum value is -180, maximum value is 180.
- Additional properties are NOT allowed
subject-id array[string]

Subject ID(s) to be considered for filtering

At least 1 element. Minimum length of each is 1.
subject-external-id array[string]

Subject external ID(s) to be considered for filtering

At least 1 element. Minimum length of each is 1, maximum length of each is 255.
subject-group-id array[string]

Subject group ID(s) to be considered for filtering

At least 1 element. Minimum length of each is 1.
subject-group-external-id array[string]

Subject group external ID(s) to be considered for filtering

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

Responses

• 200 application/json

Default Response
Hide response attributes Show response attributes object
- data array[object] Required
  
  Hide data attributes Show data attributes object
  
  id string Required
  
  Minimum length is 1.
  
  name object | null Required
  
  Hide name attributes Show name attributes
  
  language string Required
  
  Values are da, de, el, en, es, fr, ja, nl, no, or pl.
  
  value string Required
  
  Additional properties are NOT allowed
  
  description object | null Required
  
  Hide description attributes Show description attributes
  
  language string Required
  
  Values are da, de, el, en, es, fr, ja, nl, no, or pl.
  
  value string Required
  
  Additional properties are NOT allowed
  
  directions object | null Required
  
  Hide directions attributes Show directions attributes
  
  language string Required
  
  Values are da, de, el, en, es, fr, ja, nl, no, or pl.
  
  value string Required
  
  Additional properties are NOT allowed
  
  parkingInfo object | null Required
  
  Hide parkingInfo attributes Show parkingInfo attributes
  
  language string Required
  
  Values are da, de, el, en, es, fr, ja, nl, no, or pl.
  
  value string Required
  
  Additional properties are NOT allowed
  
  externalId string | null
  
  Minimum length is 1, maximum length is 255.
  
  phoneNumber string | null
  
  Minimum length is 1.
  
  location object Required
  
  Hide location attributes Show location attributes
  
  city object | null Required
  
  Hide city attributes Show city attributes
  
  language string Required
  
  Values are da, de, el, en, es, fr, ja, nl, no, or pl.
  
  value string Required
  
  Additional properties are NOT allowed
  
  state object | null Required
  
  Hide state attributes Show state attributes
  
  language string Required
  
  Values are da, de, el, en, es, fr, ja, nl, no, or pl.
  
  value string Required
  
  Additional properties are NOT allowed
  
  street1 object | null Required
  
  Hide street1 attributes Show street1 attributes
  
  language string Required
  
  Values are da, de, el, en, es, fr, ja, nl, no, or pl.
  
  value string Required
  
  Additional properties are NOT allowed
  
  street2 object | null Required
  
  Hide street2 attributes Show street2 attributes
  
  language string Required
  
  Values are da, de, el, en, es, fr, ja, nl, no, or pl.
  
  value string Required
  
  Additional properties are NOT allowed
  
  postalCode string | null
  
  Minimum length is 1.
  
  countryCode string Required
  
  Minimum length is 2, maximum length is 2.
  
  formattedAddress string Required
  
  Minimum length is 1.
  
  geolocation object Required
  
  Hide geolocation attributes Show geolocation attributes
  
  latitude number Required
  
  Minimum value is -90, maximum value is 90.
  
  longitude number Required
  
  Minimum value is -180, maximum value is 180.
  
  Additional properties are NOT allowed
  
  Additional properties are NOT allowed
  
  email string | null
  
  Minimum length is 1.
  
  virtual boolean Required
  
  timeZone string Required
  
  Minimum length is 1.
  
  Additional properties are NOT allowed
- Additional properties are NOT allowed

GET /schedulable/offices

curl \
 -X GET https://api.pexipengage.com/enterprises/acme/schedulable/offices \
 -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",
      "name": {
        "language": "en",
        "value": "Lorem ipsum"
      },
      "description": {
        "language": "en",
        "value": "Lorem ipsum"
      },
      "directions": {
        "language": "en",
        "value": "Lorem ipsum"
      },
      "parkingInfo": {
        "language": "en",
        "value": "Lorem ipsum"
      },
      "externalId": "ABCD1234",
      "phoneNumber": "+32412345678",
      "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
        }
      },
      "email": "john.doe@pexip.com",
      "virtual": true,
      "timeZone": "Europe/Brussels"
    }
  ]
}