Get employee unavailability

GET /employees/{id}/unavailability
OAuth2

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

    Default value is 25.

Responses

GET /employees/{id}/unavailability 
curl \
 -X GET https://api.pexipengage.com/enterprises/acme/employees/1234/unavailability \
 -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c" \
 -H "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"
    }
  ]
}