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

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
  }
}