---
title: "Advanced search on Agency Group Agency shifts"
method: POST
path: "/agency-group/{agency_group_id}/advanced-search/agency-shift"
tags: ["Agency Group Agency Shift Advanced Search"]
---

# Advanced search on Agency Group Agency shifts

`POST /agency-group/{agency_group_id}/advanced-search/agency-shift`

## Request

- Base URL: `http://localhost:3010/v1`
- URL: `http://localhost:3010/v1/agency-group/{agency_group_id}/advanced-search/agency-shift`
- Auth: HTTP basic

## Request body

- AgencyGroupAgencyShiftSearchAdvancedSearchQuery
  - `sort` string[]
  - `page` integer
  - `items_per_page` integer
  - `query` object
    - `and` AgencyGroupAgencyShiftSearchAdvancedSearchQueryFields[]
      - `and` AgencyGroupAgencyShiftSearchAdvancedSearchQueryFields[]
      - `or` AgencyGroupAgencyShiftSearchAdvancedSearchQueryFields[]
      - `shift_id` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `order_id` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `agency_id` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `order_reference` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `job_family_id` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `job_family_name` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `start_date` AdvancedSearchOperationsDateField
        - `equal` string, date-time, nullable
        - `greater_than` string, date-time, nullable
        - `less_than` string, date-time, nullable
        - `greater_than_equal` string, date-time, nullable
        - `less_than_equal` string, date-time, nullable
        - `in` string[]
      - `end_date` AdvancedSearchOperationsDateField
        - `equal` string, date-time, nullable
        - `greater_than` string, date-time, nullable
        - `less_than` string, date-time, nullable
        - `greater_than_equal` string, date-time, nullable
        - `less_than_equal` string, date-time, nullable
        - `in` string[]
      - `job_title_id` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `job_title_name` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `status_code` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `date_created` AdvancedSearchOperationsDateField
        - `equal` string, date-time, nullable
        - `greater_than` string, date-time, nullable
        - `less_than` string, date-time, nullable
        - `greater_than_equal` string, date-time, nullable
        - `less_than_equal` string, date-time, nullable
        - `in` string[]
      - `agency_shift_compliance_contract_id` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `agency_shift_compliance_contract_link_id` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `order_skills` object
        - `skill_id` AdvancedSearchOperationsStringField
          - `like` string, nullable
          - `equal` string, nullable
          - `in` string[]
          - `nin` string[]
          - `greater_than` string, nullable
          - `less_than` string, nullable
          - `greater_than_equal` string, nullable
          - `less_than_equal` string, nullable
        - `contains` AdvancedSearchOrderSkillQueryFields[]
          - `skill_id` AdvancedSearchOperationsStringField
            - `like` string, nullable
            - `equal` string, nullable
            - `in` string[]
            - `nin` string[]
            - `greater_than` string, nullable
            - `less_than` string, nullable
            - `greater_than_equal` string, nullable
            - `less_than_equal` string, nullable
        - `contains_any` AdvancedSearchOrderSkillQueryFields[]
          - `skill_id` AdvancedSearchOperationsStringField
            - `like` string, nullable
            - `equal` string, nullable
            - `in` string[]
            - `nin` string[]
            - `greater_than` string, nullable
            - `less_than` string, nullable
            - `greater_than_equal` string, nullable
            - `less_than_equal` string, nullable
      - `order_qualifications` object
        - `qualification_id` AdvancedSearchOperationsStringField
          - `like` string, nullable
          - `equal` string, nullable
          - `in` string[]
          - `nin` string[]
          - `greater_than` string, nullable
          - `less_than` string, nullable
          - `greater_than_equal` string, nullable
          - `less_than_equal` string, nullable
        - `contains` AdvancedSearchOrderQualificationQueryFields[]
          - `qualification_id` AdvancedSearchOperationsStringField
            - `like` string, nullable
            - `equal` string, nullable
            - `in` string[]
            - `nin` string[]
            - `greater_than` string, nullable
            - `less_than` string, nullable
            - `greater_than_equal` string, nullable
            - `less_than_equal` string, nullable
        - `contains_any` AdvancedSearchOrderQualificationQueryFields[]
          - `qualification_id` AdvancedSearchOperationsStringField
            - `like` string, nullable
            - `equal` string, nullable
            - `in` string[]
            - `nin` string[]
            - `greater_than` string, nullable
            - `less_than` string, nullable
            - `greater_than_equal` string, nullable
            - `less_than_equal` string, nullable
    - `or` AgencyGroupAgencyShiftSearchAdvancedSearchQueryFields[]
      - `and` AgencyGroupAgencyShiftSearchAdvancedSearchQueryFields[]
      - `or` AgencyGroupAgencyShiftSearchAdvancedSearchQueryFields[]
      - `shift_id` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `order_id` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `agency_id` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `order_reference` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `job_family_id` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `job_family_name` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `start_date` AdvancedSearchOperationsDateField
        - `equal` string, date-time, nullable
        - `greater_than` string, date-time, nullable
        - `less_than` string, date-time, nullable
        - `greater_than_equal` string, date-time, nullable
        - `less_than_equal` string, date-time, nullable
        - `in` string[]
      - `end_date` AdvancedSearchOperationsDateField
        - `equal` string, date-time, nullable
        - `greater_than` string, date-time, nullable
        - `less_than` string, date-time, nullable
        - `greater_than_equal` string, date-time, nullable
        - `less_than_equal` string, date-time, nullable
        - `in` string[]
      - `job_title_id` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `job_title_name` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `status_code` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `date_created` AdvancedSearchOperationsDateField
        - `equal` string, date-time, nullable
        - `greater_than` string, date-time, nullable
        - `less_than` string, date-time, nullable
        - `greater_than_equal` string, date-time, nullable
        - `less_than_equal` string, date-time, nullable
        - `in` string[]
      - `agency_shift_compliance_contract_id` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `agency_shift_compliance_contract_link_id` AdvancedSearchOperationsStringField
        - `like` string, nullable
        - `equal` string, nullable
        - `in` string[]
        - `nin` string[]
        - `greater_than` string, nullable
        - `less_than` string, nullable
        - `greater_than_equal` string, nullable
        - `less_than_equal` string, nullable
      - `order_skills` object
        - `skill_id` AdvancedSearchOperationsStringField
          - `like` string, nullable
          - `equal` string, nullable
          - `in` string[]
          - `nin` string[]
          - `greater_than` string, nullable
          - `less_than` string, nullable
          - `greater_than_equal` string, nullable
          - `less_than_equal` string, nullable
        - `contains` AdvancedSearchOrderSkillQueryFields[]
          - `skill_id` AdvancedSearchOperationsStringField
            - `like` string, nullable
            - `equal` string, nullable
            - `in` string[]
            - `nin` string[]
            - `greater_than` string, nullable
            - `less_than` string, nullable
            - `greater_than_equal` string, nullable
            - `less_than_equal` string, nullable
        - `contains_any` AdvancedSearchOrderSkillQueryFields[]
          - `skill_id` AdvancedSearchOperationsStringField
            - `like` string, nullable
            - `equal` string, nullable
            - `in` string[]
            - `nin` string[]
            - `greater_than` string, nullable
            - `less_than` string, nullable
            - `greater_than_equal` string, nullable
            - `less_than_equal` string, nullable
      - `order_qualifications` object
        - `qualification_id` AdvancedSearchOperationsStringField
          - `like` string, nullable
          - `equal` string, nullable
          - `in` string[]
          - `nin` string[]
          - `greater_than` string, nullable
          - `less_than` string, nullable
          - `greater_than_equal` string, nullable
          - `less_than_equal` string, nullable
        - `contains` AdvancedSearchOrderQualificationQueryFields[]
          - `qualification_id` AdvancedSearchOperationsStringField
            - `like` string, nullable
            - `equal` string, nullable
            - `in` string[]
            - `nin` string[]
            - `greater_than` string, nullable
            - `less_than` string, nullable
            - `greater_than_equal` string, nullable
            - `less_than_equal` string, nullable
        - `contains_any` AdvancedSearchOrderQualificationQueryFields[]
          - `qualification_id` AdvancedSearchOperationsStringField
            - `like` string, nullable
            - `equal` string, nullable
            - `in` string[]
            - `nin` string[]
            - `greater_than` string, nullable
            - `less_than` string, nullable
            - `greater_than_equal` string, nullable
            - `less_than_equal` string, nullable
  - `project` object
    - `shift_id` 1
    - `position_description` 1
    - `staffing_instructions` 1
    - `order_id` 1, required
    - `order_reference` 1
    - `start_date` 1, required
    - `end_date` 1, required
    - `job_family_id` 1
    - `job_family_name` 1
    - `job_title_id` 1
    - `job_title_name` 1
    - `status_code` 1
    - `date_created` 1
    - `agency_id` 1, required
    - `agency_name` 1
    - `agency_shift_compliance_contract_id` 1
    - `agency_shift_compliance_contract_name` 1
    - `agency_shift_compliance_contract_link_id` 1
    - `order_skills` 1
    - `order_qualifications` 1
    - `order_timezone` 1

## Response `200`

list of agency group agency shift search based on search criteria

- AgencyGroupAgencyShiftSearchAdvancedSearchResult[]
  - `_id` string
  - `agency_id` string
  - `agency_name` string
  - `shift_id` string
  - `order_id` string
  - `job_family_id` string
  - `job_family_name` string
  - `job_title_id` string
  - `job_title_name` string
  - `order_reference` string
  - `status_code` string
  - `start_date` string, date-time
  - `end_date` string, date-time
  - `date_created` string, date-time
  - `position_description` string
  - `staffing_instructions` string
  - `agency_shift_compliance_contract_id` string
  - `agency_shift_compliance_contract_name` string
  - `agency_shift_compliance_contract_link_id` string
  - `order_skills` object[]
    - `skill_id` string
  - `order_qualifications` object[]
    - `qualification_id` string
  - `order_timezone` string

## Other responses

- `204`: No content
- `400`: Validation Error. Usually caused by a missing or invalid parameter.
- `401`: Authorization Error. Thrown if the user does not have access to resource.
- `403`: Permission denied error
- `default`: Server error occurred

---

[API](https://skmtc.dev/staffshift/apis/staffshift-api-gateway.md) - [All operations](https://skmtc.dev/staffshift/apis/staffshift-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/staffshift/apis/staffshift-api-gateway/revisions/1f079f6b65f5?raw)