--- title: "Search EmployeePlacements" method: POST path: "/employee-placement/_search" tags: ["EmployeePlacement"] --- # Search EmployeePlacements `POST /employee-placement/_search` Search for `EmployeePlacements` with filtering capabilities. ## Query parameters - `limit` integer - `offset` integer ## Request body - object - `filter` EmployeePlacementFilter, required — Filter object for EmployeePlacement - `equals` EmployeePlacementFilterEquals — Equality/Inequality filter fields for EmployeePlacement - `id` string, uuid, nullable — Unique identifier for the EmployeePlacement - `meta` MetaFilterEquals — Equality/Inequality filter fields for Meta - `createdAt` string, date-time, nullable — Timestamp when the resource was created - `createdBy` string, uuid, nullable — User who created the resource - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated - `updatedBy` string, uuid, nullable — User who last updated the resource - `external` ExternalFilterEquals — Equality/Inequality filter fields for External - `sourceID` string, nullable — The ID of the external source - `source` string, nullable — The source of the external information - `employeeID` string, uuid, nullable — The ID of the employee the placement belongs to - `schoolID` string, uuid, nullable — The ID of the school the placement belongs to - `signature` string, nullable — The employee's signature — a short code, usually their initials, used to identify the employee within the school on schedules, grade documents, and other printed material (e.g. "LM" for Lise Meitner). - `title` string, nullable — The title of the employee - `roles` 'Admin' | 'CareTeam' | 'Manager' | 'MealPlanner' | 'OtherPersonnel' | 'Scheduler' | 'Teacher' — The role of the employee in the placement - `startDate` string, date, nullable — The start date of the placement for the employee - `endDate` string, date, nullable — The end date of the placement for the employee - `archiveYear` string, nullable — The year the placement was archived for the employee, in the format YYYY_YYYY where the first year is the autumn and the second year is the spring. - `archivedAt` string, date-time, nullable — The timestamp the placement was archived for the employee - `employmentPercent` integer, nullable — The percentage of employment for the employee at this school, represented as an integer (e.g., 100 for 100%, 50 for 50%) - `notEquals` EmployeePlacementFilterEquals — Equality/Inequality filter fields for EmployeePlacement - `id` string, uuid, nullable — Unique identifier for the EmployeePlacement - `meta` MetaFilterEquals — Equality/Inequality filter fields for Meta - `createdAt` string, date-time, nullable — Timestamp when the resource was created - `createdBy` string, uuid, nullable — User who created the resource - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated - `updatedBy` string, uuid, nullable — User who last updated the resource - `external` ExternalFilterEquals — Equality/Inequality filter fields for External - `sourceID` string, nullable — The ID of the external source - `source` string, nullable — The source of the external information - `employeeID` string, uuid, nullable — The ID of the employee the placement belongs to - `schoolID` string, uuid, nullable — The ID of the school the placement belongs to - `signature` string, nullable — The employee's signature — a short code, usually their initials, used to identify the employee within the school on schedules, grade documents, and other printed material (e.g. "LM" for Lise Meitner). - `title` string, nullable — The title of the employee - `roles` 'Admin' | 'CareTeam' | 'Manager' | 'MealPlanner' | 'OtherPersonnel' | 'Scheduler' | 'Teacher' — The role of the employee in the placement - `startDate` string, date, nullable — The start date of the placement for the employee - `endDate` string, date, nullable — The end date of the placement for the employee - `archiveYear` string, nullable — The year the placement was archived for the employee, in the format YYYY_YYYY where the first year is the autumn and the second year is the spring. - `archivedAt` string, date-time, nullable — The timestamp the placement was archived for the employee - `employmentPercent` integer, nullable — The percentage of employment for the employee at this school, represented as an integer (e.g., 100 for 100%, 50 for 50%) - `greaterThan` EmployeePlacementFilterRange — Range filter fields for EmployeePlacement - `meta` MetaFilterRange — Range filter fields for Meta - `createdAt` string, date-time, nullable — Timestamp when the resource was created - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated - `external` ExternalFilterRange — Range filter fields for External - `startDate` string, date, nullable — The start date of the placement for the employee - `endDate` string, date, nullable — The end date of the placement for the employee - `archivedAt` string, date-time, nullable — The timestamp the placement was archived for the employee - `employmentPercent` integer, nullable — The percentage of employment for the employee at this school, represented as an integer (e.g., 100 for 100%, 50 for 50%) - `smallerThan` EmployeePlacementFilterRange — Range filter fields for EmployeePlacement - `meta` MetaFilterRange — Range filter fields for Meta - `createdAt` string, date-time, nullable — Timestamp when the resource was created - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated - `external` ExternalFilterRange — Range filter fields for External - `startDate` string, date, nullable — The start date of the placement for the employee - `endDate` string, date, nullable — The end date of the placement for the employee - `archivedAt` string, date-time, nullable — The timestamp the placement was archived for the employee - `employmentPercent` integer, nullable — The percentage of employment for the employee at this school, represented as an integer (e.g., 100 for 100%, 50 for 50%) - `greaterOrEqual` EmployeePlacementFilterRange — Range filter fields for EmployeePlacement - `meta` MetaFilterRange — Range filter fields for Meta - `createdAt` string, date-time, nullable — Timestamp when the resource was created - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated - `external` ExternalFilterRange — Range filter fields for External - `startDate` string, date, nullable — The start date of the placement for the employee - `endDate` string, date, nullable — The end date of the placement for the employee - `archivedAt` string, date-time, nullable — The timestamp the placement was archived for the employee - `employmentPercent` integer, nullable — The percentage of employment for the employee at this school, represented as an integer (e.g., 100 for 100%, 50 for 50%) - `smallerOrEqual` EmployeePlacementFilterRange — Range filter fields for EmployeePlacement - `meta` MetaFilterRange — Range filter fields for Meta - `createdAt` string, date-time, nullable — Timestamp when the resource was created - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated - `external` ExternalFilterRange — Range filter fields for External - `startDate` string, date, nullable — The start date of the placement for the employee - `endDate` string, date, nullable — The end date of the placement for the employee - `archivedAt` string, date-time, nullable — The timestamp the placement was archived for the employee - `employmentPercent` integer, nullable — The percentage of employment for the employee at this school, represented as an integer (e.g., 100 for 100%, 50 for 50%) - `contains` EmployeePlacementFilterContains — Contains filter fields for EmployeePlacement - `id` string[] — Unique identifier for the EmployeePlacement - `meta` MetaFilterContains — Contains filter fields for Meta - `createdBy` string[] — User who created the resource - `updatedBy` string[] — User who last updated the resource - `external` ExternalFilterContains — Contains filter fields for External - `sourceID` string[] — The ID of the external source - `source` string[] — The source of the external information - `employeeID` string[] — The ID of the employee the placement belongs to - `schoolID` string[] — The ID of the school the placement belongs to - `signature` string[] — The employee's signature — a short code, usually their initials, used to identify the employee within the school on schedules, grade documents, and other printed material (e.g. "LM" for Lise Meitner). - `title` string[] — The title of the employee - `roles` EmployeePlacementRole[] — The roles of the employee - `startDate` string[] — The start date of the placement for the employee - `endDate` string[] — The end date of the placement for the employee - `archiveYear` string[] — The year the placement was archived for the employee, in the format YYYY_YYYY where the first year is the autumn and the second year is the spring. - `employmentPercent` integer[] — The percentage of employment for the employee at this school, represented as an integer (e.g., 100 for 100%, 50 for 50%) - `notContains` EmployeePlacementFilterContains — Contains filter fields for EmployeePlacement - `id` string[] — Unique identifier for the EmployeePlacement - `meta` MetaFilterContains — Contains filter fields for Meta - `createdBy` string[] — User who created the resource - `updatedBy` string[] — User who last updated the resource - `external` ExternalFilterContains — Contains filter fields for External - `sourceID` string[] — The ID of the external source - `source` string[] — The source of the external information - `employeeID` string[] — The ID of the employee the placement belongs to - `schoolID` string[] — The ID of the school the placement belongs to - `signature` string[] — The employee's signature — a short code, usually their initials, used to identify the employee within the school on schedules, grade documents, and other printed material (e.g. "LM" for Lise Meitner). - `title` string[] — The title of the employee - `roles` EmployeePlacementRole[] — The roles of the employee - `startDate` string[] — The start date of the placement for the employee - `endDate` string[] — The end date of the placement for the employee - `archiveYear` string[] — The year the placement was archived for the employee, in the format YYYY_YYYY where the first year is the autumn and the second year is the spring. - `employmentPercent` integer[] — The percentage of employment for the employee at this school, represented as an integer (e.g., 100 for 100%, 50 for 50%) - `like` EmployeePlacementFilterLike — LIKE filter fields for EmployeePlacement - `meta` MetaFilterLike — LIKE filter fields for Meta - `external` ExternalFilterLike — LIKE filter fields for External - `sourceID` string, nullable — The ID of the external source - `source` string, nullable — The source of the external information - `signature` string, nullable — The employee's signature — a short code, usually their initials, used to identify the employee within the school on schedules, grade documents, and other printed material (e.g. "LM" for Lise Meitner). - `title` string, nullable — The title of the employee - `archiveYear` string, nullable — The year the placement was archived for the employee, in the format YYYY_YYYY where the first year is the autumn and the second year is the spring. - `notLike` EmployeePlacementFilterLike — LIKE filter fields for EmployeePlacement - `meta` MetaFilterLike — LIKE filter fields for Meta - `external` ExternalFilterLike — LIKE filter fields for External - `sourceID` string, nullable — The ID of the external source - `source` string, nullable — The source of the external information - `signature` string, nullable — The employee's signature — a short code, usually their initials, used to identify the employee within the school on schedules, grade documents, and other printed material (e.g. "LM" for Lise Meitner). - `title` string, nullable — The title of the employee - `archiveYear` string, nullable — The year the placement was archived for the employee, in the format YYYY_YYYY where the first year is the autumn and the second year is the spring. - `null` EmployeePlacementFilterNull — Null filter fields for EmployeePlacement - `meta` MetaFilterNull — Null filter fields for Meta - `createdBy` boolean, nullable — User who created the resource - `updatedAt` boolean, nullable — Timestamp when the resource was last updated - `updatedBy` boolean, nullable — User who last updated the resource - `external` ExternalFilterNull — Null filter fields for External - `sourceID` boolean, nullable — The ID of the external source - `source` boolean, nullable — The source of the external information - `signature` boolean, nullable — The employee's signature — a short code, usually their initials, used to identify the employee within the school on schedules, grade documents, and other printed material (e.g. "LM" for Lise Meitner). - `title` boolean, nullable — The title of the employee - `roles` boolean, nullable — The roles of the employee - `endDate` boolean, nullable — The end date of the placement for the employee - `archiveYear` boolean, nullable — The year the placement was archived for the employee, in the format YYYY_YYYY where the first year is the autumn and the second year is the spring. - `archivedAt` boolean, nullable — The timestamp the placement was archived for the employee - `employmentPercent` boolean, nullable — The percentage of employment for the employee at this school, represented as an integer (e.g., 100 for 100%, 50 for 50%) - `notNull` EmployeePlacementFilterNull — Null filter fields for EmployeePlacement - `meta` MetaFilterNull — Null filter fields for Meta - `createdBy` boolean, nullable — User who created the resource - `updatedAt` boolean, nullable — Timestamp when the resource was last updated - `updatedBy` boolean, nullable — User who last updated the resource - `external` ExternalFilterNull — Null filter fields for External - `sourceID` boolean, nullable — The ID of the external source - `source` boolean, nullable — The source of the external information - `signature` boolean, nullable — The employee's signature — a short code, usually their initials, used to identify the employee within the school on schedules, grade documents, and other printed material (e.g. "LM" for Lise Meitner). - `title` boolean, nullable — The title of the employee - `roles` boolean, nullable — The roles of the employee - `endDate` boolean, nullable — The end date of the placement for the employee - `archiveYear` boolean, nullable — The year the placement was archived for the employee, in the format YYYY_YYYY where the first year is the autumn and the second year is the spring. - `archivedAt` boolean, nullable — The timestamp the placement was archived for the employee - `employmentPercent` boolean, nullable — The percentage of employment for the employee at this school, represented as an integer (e.g., 100 for 100%, 50 for 50%) - `orCondition` boolean, required — OrCondition decides if this filter is within an OR-condition or AND-condition - `nestedFilters` EmployeePlacementFilter[] — NestedFilters of the EmployeePlacement, useful for more complex filters ## Response `200` Response for EmployeePlacement Search operation - returns filtered EmployeePlacement results - object - `data` EmployeePlacement[] — Array of EmployeePlacement objects - `id` string, uuid, required — Unique identifier for the EmployeePlacement - `meta` Meta — Meta contains information about the creation and modification of a resource for auditing purposes - `createdAt` string, date-time, required — Timestamp when the resource was created - `createdBy` string, uuid, nullable — User who created the resource - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated - `updatedBy` string, uuid, nullable — User who last updated the resource - `external` External — External is a reusable object that can be used to store external information from another system, used for third-party integration tracking. - `sourceID` string, nullable — The ID of the external source - `source` string, nullable — The source of the external information - `employeeID` string, uuid, required — The ID of the employee the placement belongs to - `schoolID` string, uuid, required — The ID of the school the placement belongs to - `signature` string, nullable — The employee's signature — a short code, usually their initials, used to identify the employee within the school on schedules, grade documents, and other printed material (e.g. "LM" for Lise Meitner). - `title` string, nullable — The title of the employee - `roles` EmployeePlacementRole[] — The roles of the employee - `startDate` string, date, required — The start date of the placement for the employee - `endDate` string, date, nullable — The end date of the placement for the employee - `archiveYear` string, nullable — The year the placement was archived for the employee, in the format YYYY_YYYY where the first year is the autumn and the second year is the spring. - `archivedAt` string, date-time, nullable — The timestamp the placement was archived for the employee - `employmentPercent` integer, nullable — The percentage of employment for the employee at this school, represented as an integer (e.g., 100 for 100%, 50 for 50%) - `pagination` Pagination — Pagination parameters for controlling result sets in list operations - `offset` integer, required — Number of items to skip from the beginning of the result set - `limit` integer, required — Maximum number of items to return in the result set - `total` integer, required — Total number of items available for pagination ## Other responses - `400` — Bad Request - The request was malformed or contained invalid parameters - `401` — Unauthorized - The request is missing valid authentication credentials - `403` — Forbidden - Request is authenticated, but the user is not allowed to perform the operation - `404` — Not Found - The requested resource does not exist - `409` — Conflict - The request could not be completed due to a conflict - `422` — Validation error for EmployeePlacement Search operation - request data failed validation - `429` — Too Many Requests - When the rate limit has been exceeded - `500` — Internal Server Error - An unexpected server error occurred --- [API](https://skmtc.net/meitner/apis/directory-api.md) · [All operations](https://skmtc.net/meitner/apis/directory-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meitner/directory-api/revisions/014348a7bc35/schema)