Get employees

GET /employees

Get employees 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.

  • email array[string]

    Email(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.

  • available-role array[string]

    Available role(s) to be considered for filtering

    At least 1 element. Values are ADMIN, AGENT, CENTRAL_PLANNER, or OFFICE_MANAGER.

  • username array[string]

    Username(s) to be considered for filtering

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

  • status array[string]

    Status(es) to be considered for filtering

    At least 1 element. Values are ACTIVE, PENDING, or SUSPENDED.

  • 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.

  • Includes deleted resources in the results

Responses

  • 200 application/json

    Successful operation

    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.

      • function object | null Required

        Additional properties are NOT allowed.

        Hide function attributes Show function attributes object | null
        • language string Required

          Values are da, de, el, en, es, fr, ja, nl, no, or pl.

        • value string Required
      • communicationEmail string | null

        Minimum length is 1.

      • externalId string | null

        Minimum length is 1, maximum length is 255.

      • username string | null

        Minimum length is 1, maximum length is 255.

      • firstName string Required

        Minimum length is 1.

      • lastName string Required

        Minimum length is 1.

      • staticVideoUrl string(uri) | null

        Minimum length is 1.

      • phoneNumber string | null

        Minimum length is 1.

      • profilePictureUrl string(uri) | null

        Minimum length is 1.

      • email string Required

        Minimum length is 1.

      • language string Required

        Values are da, de, el, en, es, fr, ja, nl, no, or pl.

      • timeZone string Required

        Minimum length is 1.

      • availableRoles array[string] Required

        Values are ADMIN, AGENT, CENTRAL_PLANNER, or OFFICE_MANAGER.

      • status string Required

        Values are ACTIVE, PENDING, or SUSPENDED.

      • onlinePlanning boolean Required
      • officeRelations array[object] Required
        Hide officeRelations attributes Show officeRelations attributes object
        • role string Required

          Values are AGENT or OFFICE_MANAGER.

        • office object Required

          Additional properties are NOT allowed.

          Hide office attribute Show office attribute object
          • id string Required

            Minimum length is 1.

      • createdAt string(date-time) Required

        Minimum length is 1.

      • updatedAt string(date-time) Required

        Minimum length is 1.

      • deletedAt string(date-time) | null 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.

GET /employees
curl \
 -X GET https://api.development.pexipengage.com/enterprises/acme/employees \
 -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",
      "function": {
        "language": "en",
        "value": "Lorem ipsum"
      },
      "communicationEmail": "john.doe@pexip.com",
      "externalId": "ABCD1234",
      "username": "ABCD1234",
      "firstName": "John",
      "lastName": "Doe",
      "staticVideoUrl": "https://wwww.example.net/abc123",
      "phoneNumber": "+32412345678",
      "profilePictureUrl": "https://wwww.example.net/abc123",
      "email": "john.doe@pexip.com",
      "language": "en",
      "timeZone": "Europe/Brussels",
      "availableRoles": [
        "ADMIN"
      ],
      "status": "ACTIVE",
      "onlinePlanning": true,
      "officeRelations": [
        {
          "role": "AGENT",
          "office": {
            "id": "123"
          }
        }
      ],
      "createdAt": "2022-08-17T19:05:21.362Z",
      "updatedAt": "2022-08-17T19:05:21.362Z",
      "deletedAt": "2022-08-17T19:05:21.362Z"
    }
  ],
  "meta": {
    "offset": 0,
    "limit": 25,
    "totalCount": 42
  }
}