v2

latestOpenAPI 3.1.0Proprietary - Licensed to Authorized Customers Only2026-07-31611061.1 MB
Employee

Search Employees

Search for Employees with filtering capabilities.

post/employee/_search

Query parameters

limitinteger
Example:1

The maximum number of Employees to return (default: 50) when searching Employees

offsetinteger

The number of Employees to skip before starting to return results (default: 0) when searching Employees

Request body

Example request

{
  "filter": {
    "equals": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "meta": {
        "createdAt": "2024-01-15T10:30:00Z",
        "createdBy": "123e4567-e89b-12d3-a456-426614174000",
        "updatedAt": "2024-01-15T10:30:00Z",
        "updatedBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "external": {
        "sourceID": "example",
        "source": "example"
      },
      "identityNumber": "example",
      "identityTemporary": true,
      "firstName": "example",
      "lastName": "example",
      "dateOfBirth": "2024-01-15",
      "address": {
        "postalAddress": "example",
        "postalCode": "example",
        "postalCity": "example",
        "countryCode": "example",
        "municipalityCode": "example"
      },
      "emailAddress1": "example",
      "emailAddress2": "example",
      "phoneNumber1": "example",
      "phoneNumber2": "example",
      "eduPersonPrincipalName": "example"
    },
    "notEquals": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "meta": {
        "createdAt": "2024-01-15T10:30:00Z",
        "createdBy": "123e4567-e89b-12d3-a456-426614174000",
        "updatedAt": "2024-01-15T10:30:00Z",
        "updatedBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "external": {
        "sourceID": "example",
        "source": "example"
      },
      "identityNumber": "example",
      "identityTemporary": true,
      "firstName": "example",
      "lastName": "example",
      "dateOfBirth": "2024-01-15",
      "address": {
        "postalAddress": "example",
        "postalCode": "example",
        "postalCity": "example",
        "countryCode": "example",
        "municipalityCode": "example"
      },
      "emailAddress1": "example",
      "emailAddress2": "example",
      "phoneNumber1": "example",
      "phoneNumber2": "example",
      "eduPersonPrincipalName": "example"
    },
    "greaterThan": {
      "meta": {
        "createdAt": "2024-01-15T10:30:00Z",
        "updatedAt": "2024-01-15T10:30:00Z"
      },
      "dateOfBirth": "2024-01-15"
    },
    "smallerThan": {
      "meta": {
        "createdAt": "2024-01-15T10:30:00Z",
        "updatedAt": "2024-01-15T10:30:00Z"
      },
      "dateOfBirth": "2024-01-15"
    },
    "greaterOrEqual": {
      "meta": {
        "createdAt": "2024-01-15T10:30:00Z",
        "updatedAt": "2024-01-15T10:30:00Z"
      },
      "dateOfBirth": "2024-01-15"
    },
    "smallerOrEqual": {
      "meta": {
        "createdAt": "2024-01-15T10:30:00Z",
        "updatedAt": "2024-01-15T10:30:00Z"
      },
      "dateOfBirth": "2024-01-15"
    },
    "contains": {
      "id": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "meta": {
        "createdBy": [
          "123e4567-e89b-12d3-a456-426614174000"
        ],
        "updatedBy": [
          "123e4567-e89b-12d3-a456-426614174000"
        ]
      },
      "external": {
        "sourceID": [
          "example"
        ],
        "source": [
          "example"
        ]
      },
      "identityNumber": [
        "example"
      ],
      "identityTemporary": [
        true
      ],
      "firstName": [
        "example"
      ],
      "lastName": [
        "example"
      ],
      "dateOfBirth": [
        "2024-01-15"
      ],
      "address": {
        "postalAddress": [
          "example"
        ],
        "postalCode": [
          "example"
        ],
        "postalCity": [
          "example"
        ],
        "countryCode": [
          "example"
        ],
        "municipalityCode": [
          "example"
        ]
      },
      "emailAddress1": [
        "example"
      ],
      "emailAddress2": [
        "example"
      ],
      "phoneNumber1": [
        "example"
      ],
      "phoneNumber2": [
        "example"
      ],
      "eduPersonPrincipalName": [
        "example"
      ]
    },
    "notContains": {
      "id": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "meta": {
        "createdBy": [
          "123e4567-e89b-12d3-a456-426614174000"
        ],
        "updatedBy": [
          "123e4567-e89b-12d3-a456-426614174000"
        ]
      },
      "external": {
        "sourceID": [
          "example"
        ],
        "source": [
          "example"
        ]
      },
      "identityNumber": [
        "example"
      ],
      "identityTemporary": [
        true
      ],
      "firstName": [
        "example"
      ],
      "lastName": [
        "example"
      ],
      "dateOfBirth": [
        "2024-01-15"
      ],
      "address": {
        "postalAddress": [
          "example"
        ],
        "postalCode": [
          "example"
        ],
        "postalCity": [
          "example"
        ],
        "countryCode": [
          "example"
        ],
        "municipalityCode": [
          "example"
        ]
      },
      "emailAddress1": [
        "example"
      ],
      "emailAddress2": [
        "example"
      ],
      "phoneNumber1": [
        "example"
      ],
      "phoneNumber2": [
        "example"
      ],
      "eduPersonPrincipalName": [
        "example"
      ]
    },
    "like": {
      "external": {
        "sourceID": "example",
        "source": "example"
      },
      "identityNumber": "example",
      "firstName": "example",
      "lastName": "example",
      "address": {
        "postalAddress": "example",
        "postalCode": "example",
        "postalCity": "example",
        "countryCode": "example",
        "municipalityCode": "example"
      },
      "emailAddress1": "example",
      "emailAddress2": "example",
      "phoneNumber1": "example",
      "phoneNumber2": "example",
      "eduPersonPrincipalName": "example"
    },
    "notLike": {
      "external": {
        "sourceID": "example",
        "source": "example"
      },
      "identityNumber": "example",
      "firstName": "example",
      "lastName": "example",
      "address": {
        "postalAddress": "example",
        "postalCode": "example",
        "postalCity": "example",
        "countryCode": "example",
        "municipalityCode": "example"
      },
      "emailAddress1": "example",
      "emailAddress2": "example",
      "phoneNumber1": "example",
      "phoneNumber2": "example",
      "eduPersonPrincipalName": "example"
    },
    "null": {
      "meta": {
        "createdBy": true,
        "updatedAt": true,
        "updatedBy": true
      },
      "external": {
        "sourceID": true,
        "source": true
      },
      "gender": true,
      "dateOfBirth": true,
      "address": {
        "postalAddress": true,
        "postalCode": true,
        "postalCity": true,
        "countryCode": true,
        "municipalityCode": true
      },
      "emailAddress1": true,
      "emailAddress2": true,
      "phoneNumber1": true,
      "phoneNumber2": true,
      "eduPersonPrincipalName": true
    },
    "notNull": {
      "meta": {
        "createdBy": true,
        "updatedAt": true,
        "updatedBy": true
      },
      "external": {
        "sourceID": true,
        "source": true
      },
      "gender": true,
      "dateOfBirth": true,
      "address": {
        "postalAddress": true,
        "postalCode": true,
        "postalCity": true,
        "countryCode": true,
        "municipalityCode": true
      },
      "emailAddress1": true,
      "emailAddress2": true,
      "phoneNumber1": true,
      "phoneNumber2": true,
      "eduPersonPrincipalName": true
    },
    "orCondition": true,
    "nestedFilters": [
      {
        "equals": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "meta": {
            "createdAt": "2024-01-15T10:30:00Z",
            "createdBy": "123e4567-e89b-12d3-a456-426614174000",
            "updatedAt": "2024-01-15T10:30:00Z",
            "updatedBy": "123e4567-e89b-12d3-a456-426614174000"
          },
          "external": {
            "sourceID": "example",
            "source": "example"
          },
          "identityNumber": "example",
          "identityTemporary": true,
          "firstName": "example",
          "lastName": "example",
          "dateOfBirth": "2024-01-15",
          "address": {
            "postalAddress": "example",
            "postalCode": "example",
            "postalCity": "example",
            "countryCode": "example",
            "municipalityCode": "example"
          },
          "emailAddress1": "example",
          "emailAddress2": "example",
          "phoneNumber1": "example",
          "phoneNumber2": "example",
          "eduPersonPrincipalName": "example"
        },
        "notEquals": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "meta": {
            "createdAt": "2024-01-15T10:30:00Z",
            "createdBy": "123e4567-e89b-12d3-a456-426614174000",
            "updatedAt": "2024-01-15T10:30:00Z",
            "updatedBy": "123e4567-e89b-12d3-a456-426614174000"
          },
          "external": {
            "sourceID": "example",
            "source": "example"
          },
          "identityNumber": "example",
          "identityTemporary": true,
          "firstName": "example",
          "lastName": "example",
          "dateOfBirth": "2024-01-15",
          "address": {
            "postalAddress": "example",
            "postalCode": "example",
            "postalCity": "example",
            "countryCode": "example",
            "municipalityCode": "example"
          },
          "emailAddress1": "example",
          "emailAddress2": "example",
          "phoneNumber1": "example",
          "phoneNumber2": "example",
          "eduPersonPrincipalName": "example"
        },
        "greaterThan": {
          "meta": {
            "createdAt": "2024-01-15T10:30:00Z",
            "updatedAt": "2024-01-15T10:30:00Z"
          },
          "dateOfBirth": "2024-01-15"
        },
        "smallerThan": {
          "meta": {
            "createdAt": "2024-01-15T10:30:00Z",
            "updatedAt": "2024-01-15T10:30:00Z"
          },
          "dateOfBirth": "2024-01-15"
        },
        "greaterOrEqual": {
          "meta": {
            "createdAt": "2024-01-15T10:30:00Z",
            "updatedAt": "2024-01-15T10:30:00Z"
          },
          "dateOfBirth": "2024-01-15"
        },
        "smallerOrEqual": {
          "meta": {
            "createdAt": "2024-01-15T10:30:00Z",
            "updatedAt": "2024-01-15T10:30:00Z"
          },
          "dateOfBirth": "2024-01-15"
        },
        "contains": {
          "id": [
            "123e4567-e89b-12d3-a456-426614174000"
          ],
          "meta": {
            "createdBy": [
              "123e4567-e89b-12d3-a456-426614174000"
            ],
            "updatedBy": [
              "123e4567-e89b-12d3-a456-426614174000"
            ]
          },
          "external": {
            "sourceID": [
              "example"
            ],
            "source": [
              "example"
            ]
          },
          "identityNumber": [
            "example"
          ],
          "identityTemporary": [
            true
          ],
          "firstName": [
            "example"
          ],
          "lastName": [
            "example"
          ],
          "dateOfBirth": [
            "2024-01-15"
          ],
          "address": {
            "postalAddress": [
              "example"
            ],
            "postalCode": [
              "example"
            ],
            "postalCity": [
              "example"
            ],
            "countryCode": [
              "example"
            ],
            "municipalityCode": [
              "example"
            ]
          },
          "emailAddress1": [
            "example"
          ],
          "emailAddress2": [
            "example"
          ],
          "phoneNumber1": [
            "example"
          ],
          "phoneNumber2": [
            "example"
          ],
          "eduPersonPrincipalName": [
            "example"
          ]
        },
        "notContains": {
          "id": [
            "123e4567-e89b-12d3-a456-426614174000"
          ],
          "meta": {
            "createdBy": [
              "123e4567-e89b-12d3-a456-426614174000"
            ],
            "updatedBy": [
              "123e4567-e89b-12d3-a456-426614174000"
            ]
          },
          "external": {
            "sourceID": [
              "example"
            ],
            "source": [
              "example"
            ]
          },
          "identityNumber": [
            "example"
          ],
          "identityTemporary": [
            true
          ],
          "firstName": [
            "example"
          ],
          "lastName": [
            "example"
          ],
          "dateOfBirth": [
            "2024-01-15"
          ],
          "address": {
            "postalAddress": [
              "example"
            ],
            "postalCode": [
              "example"
            ],
            "postalCity": [
              "example"
            ],
            "countryCode": [
              "example"
            ],
            "municipalityCode": [
              "example"
            ]
          },
          "emailAddress1": [
            "example"
          ],
          "emailAddress2": [
            "example"
          ],
          "phoneNumber1": [
            "example"
          ],
          "phoneNumber2": [
            "example"
          ],
          "eduPersonPrincipalName": [
            "example"
          ]
        },
        "like": {
          "external": {
            "sourceID": "example",
            "source": "example"
          },
          "identityNumber": "example",
          "firstName": "example",
          "lastName": "example",
          "address": {
            "postalAddress": "example",
            "postalCode": "example",
            "postalCity": "example",
            "countryCode": "example",
            "municipalityCode": "example"
          },
          "emailAddress1": "example",
          "emailAddress2": "example",
          "phoneNumber1": "example",
          "phoneNumber2": "example",
          "eduPersonPrincipalName": "example"
        },
        "notLike": {
          "external": {
            "sourceID": "example",
            "source": "example"
          },
          "identityNumber": "example",
          "firstName": "example",
          "lastName": "example",
          "address": {
            "postalAddress": "example",
            "postalCode": "example",
            "postalCity": "example",
            "countryCode": "example",
            "municipalityCode": "example"
          },
          "emailAddress1": "example",
          "emailAddress2": "example",
          "phoneNumber1": "example",
          "phoneNumber2": "example",
          "eduPersonPrincipalName": "example"
        },
        "null": {
          "meta": {
            "createdBy": true,
            "updatedAt": true,
            "updatedBy": true
          },
          "external": {
            "sourceID": true,
            "source": true
          },
          "gender": true,
          "dateOfBirth": true,
          "address": {
            "postalAddress": true,
            "postalCode": true,
            "postalCity": true,
            "countryCode": true,
            "municipalityCode": true
          },
          "emailAddress1": true,
          "emailAddress2": true,
          "phoneNumber1": true,
          "phoneNumber2": true,
          "eduPersonPrincipalName": true
        },
        "notNull": {
          "meta": {
            "createdBy": true,
            "updatedAt": true,
            "updatedBy": true
          },
          "external": {
            "sourceID": true,
            "source": true
          },
          "gender": true,
          "dateOfBirth": true,
          "address": {
            "postalAddress": true,
            "postalCode": true,
            "postalCity": true,
            "countryCode": true,
            "municipalityCode": true
          },
          "emailAddress1": true,
          "emailAddress2": true,
          "phoneNumber1": true,
          "phoneNumber2": true,
          "eduPersonPrincipalName": true
        },
        "orCondition": true
      }
    ]
  }
}

Response

Response for Employee Search operation - returns filtered Employee results

Example response

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "meta": {
        "createdAt": "2024-01-15T10:30:00Z",
        "createdBy": "987fcdeb-51a2-43d1-b567-123456789abc",
        "updatedAt": "2024-01-15T14:45:00Z",
        "updatedBy": "987fcdeb-51a2-43d1-b567-123456789abc"
      },
      "external": {
        "sourceID": "12345678",
        "source": "ExternalIntegrationAPI"
      },
      "gender": "Female",
      "identityNumber": "20191216-1234",
      "identityTemporary": true,
      "firstName": "Lise",
      "lastName": "Meitner",
      "dateOfBirth": "2019-12-16",
      "address": {
        "postalAddress": "Dalvägen 14",
        "postalCode": "169 56",
        "postalCity": "Solna",
        "countryCode": "SWE",
        "municipalityCode": "0184"
      },
      "emailAddress1": "lise@meitner.se",
      "emailAddress2": "lise@gmail.com",
      "phoneNumber1": "+46701234567",
      "phoneNumber2": "+46701234567",
      "eduPersonPrincipalName": "kalko@edu.goteborg.se"
    }
  ],
  "pagination": {
    "limit": 1,
    "total": 100
  }
}