Get employee unavailability

GET /employees/{id}/unavailability

O auth2

Get unavailability for an employee by its ID 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.

Path parameters

id string Required

Primary identifier of the requested resource

Minimum length is 1.

Query parameters

start string(date-time)

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

Minimum length is 1.
end string(date-time)

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

Minimum length is 1.
type array[string]

Unavailability type(s) to be considered for filtering

At least 1 element. Values are APPOINTMENT, EXTERNAL_CALENDAR, LISTING_EXCLUSIVITY, or USER_DEFINED.
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, number between 1 and 1000.

Format should match the following pattern: ^([1-9]|[1-9][0-9]{1,2}|1000)$. Default value is 25.

Responses

200 application/json

Successful operation
Hide response attributes Show response attributes object
- data array[object] Required
  
  Hide data attributes Show data attributes object
  
  employee object Required
  
  Additional properties are NOT allowed.
  
  Hide employee attribute Show employee attribute object
  
  id string Required
  
  Minimum length is 1.
  
  start string(date-time) | null
  
  Minimum length is 1.
  
  startDate string | null
  
  Minimum length is 1.
  
  end string(date-time) | null
  
  Minimum length is 1.
  
  endDate string | null
  
  Minimum length is 1.
  
  type string Required
  
  Values are APPOINTMENT, EXTERNAL_CALENDAR, LISTING_EXCLUSIVITY, or USER_DEFINED.
  
  externalId string | null
  
  Minimum length is 1, maximum length is 255.
  
  createdAt string(date-time) Required
  
  Minimum length is 1.
  
  updatedAt string(date-time) Required
  
  Minimum length is 1.
- meta object Required
  
  Additional properties are NOT allowed.
  
  Hide meta attributes Show meta attributes object
  
  offset integer Required
  
  Minimum value is 0. Default value is 0.
  
  limit integer Required
  
  Minimum value is 0. Default value is 25.
  
  totalCount integer Required
  
  Minimum value is 0.
404 application/json

Resource not found
Hide response attribute Show response attribute object
- errors array[object] Required
  
  At least 1 element.
  
  Hide errors attributes Show errors attributes object
  
  message string Required
  
  Minimum length is 1.
  
  code string Required
  
  Minimum length is 1.
  
  type string Required
  
  Minimum length is 1.
  
  statusCode string Required
  
  Minimum length is 1.

GET /employees/{id}/unavailability

curl \
 --request GET 'https://api.staging.pexipengage.com/enterprises/acme/employees/1234/unavailability' \
 --header "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c" \
 --header "X-Correlation-Id: a4f0048e-c983-11ed-afa1-0242ac120002"

Response examples (200)

{
  "data": [
    {
      "employee": {
        "id": "123"
      },
      "start": "2022-08-01T00:00:00.000Z",
      "startDate": "2022-08-01",
      "end": "2022-08-17T00:00:00.000Z",
      "endDate": "2022-08-17",
      "type": "USER_DEFINED",
      "externalId": "ABCD1234",
      "createdAt": "2022-08-17T19:05:21.362Z",
      "updatedAt": "2022-08-17T19:05:21.362Z"
    }
  ],
  "meta": {
    "offset": 0,
    "limit": 25,
    "totalCount": 42
  }
}

Response examples (404)

{
  "errors": [
    {
      "message": "string",
      "code": "string",
      "type": "string",
      "statusCode": "string"
    }
  ]
}