---
title: "Advanced search on Agency Previously Booked Candidates"
method: POST
path: "/agency/{agency_id}/advanced-search/previously-booked-agency-candidate"
tags: ["Agency Previously Booked Candidate Advanced Search"]
---

# Advanced search on Agency Previously Booked Candidates

`POST /agency/{agency_id}/advanced-search/previously-booked-agency-candidate`

## Request

- Base URL: `http://localhost:3010/v1`
- URL: `http://localhost:3010/v1/agency/{agency_id}/advanced-search/previously-booked-agency-candidate`
- Auth: HTTP basic

## Request body

- AgencyPreviouslyBookedCandidateAdvancedSearchQuery
  - `sort` string[]
  - `page` integer
  - `items_per_page` integer
  - `query` object
    - `and` AgencyPreviouslyBookedCandidateAdvancedSearchQueryFields[]
      - `and` AgencyPreviouslyBookedCandidateAdvancedSearchQueryFields[]
      - `or` AgencyPreviouslyBookedCandidateAdvancedSearchQueryFields[]
      - `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
      - `organisation_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
      - `site_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
      - `site_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
      - `ward_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
      - `ward_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
      - `candidate_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
      - `candidate_full_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
      - `candidate_type` 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
      - `candidate_status` AdvancedSearchCurrentStatusQueryFields
        - `status` 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_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
        - `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[]
      - `candidate_type_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_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
      - `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
      - `booking_count` AdvancedSearchOperationsNumberField
        - `equal` number, nullable
        - `greater_than` number, nullable
        - `less_than` number, nullable
        - `greater_than_equal` number, nullable
        - `less_than_equal` number, nullable
        - `in` number[]
        - `nin` number[]
      - `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
      - `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
      - `compliance_contract_status` 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
      - `last_shift_worked_at` 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[]
      - `next_shift_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[]
      - `currently_excluded` AdvancedSearchOperationsBooleanField
        - `equal` boolean
      - `compliant` AdvancedSearchOperationsBooleanField
        - `equal` boolean
      - `availability_last_updated_at` 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[]
      - `available` object
        - `status` 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
        - `period` 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
        - `range_start` AdvancedSearchOperationsDateWithoutTimeField
          - `equal` string, date, nullable
          - `greater_than` string, date, nullable
          - `less_than` string, date, nullable
          - `greater_than_equal` string, date, nullable
          - `less_than_equal` string, date, nullable
          - `in` string[]
        - `range_end` AdvancedSearchOperationsDateWithoutTimeField
          - `equal` string, date, nullable
          - `greater_than` string, date, nullable
          - `less_than` string, date, nullable
          - `greater_than_equal` string, date, nullable
          - `less_than_equal` string, date, nullable
          - `in` string[]
        - `contains` object[]
          - `status` 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
          - `period` 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
          - `range_start` AdvancedSearchOperationsDateWithoutTimeField
            - `equal` string, date, nullable
            - `greater_than` string, date, nullable
            - `less_than` string, date, nullable
            - `greater_than_equal` string, date, nullable
            - `less_than_equal` string, date, nullable
            - `in` string[]
          - `range_end` AdvancedSearchOperationsDateWithoutTimeField
            - `equal` string, date, nullable
            - `greater_than` string, date, nullable
            - `less_than` string, date, nullable
            - `greater_than_equal` string, date, nullable
            - `less_than_equal` string, date, nullable
            - `in` string[]
        - `contains_any` object[]
          - `status` 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
          - `period` 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
          - `range_start` AdvancedSearchOperationsDateWithoutTimeField
            - `equal` string, date, nullable
            - `greater_than` string, date, nullable
            - `less_than` string, date, nullable
            - `greater_than_equal` string, date, nullable
            - `less_than_equal` string, date, nullable
            - `in` string[]
          - `range_end` AdvancedSearchOperationsDateWithoutTimeField
            - `equal` string, date, nullable
            - `greater_than` string, date, nullable
            - `less_than` string, date, nullable
            - `greater_than_equal` string, date, nullable
            - `less_than_equal` string, date, nullable
            - `in` string[]
    - `or` AgencyPreviouslyBookedCandidateAdvancedSearchQueryFields[]
      - `and` AgencyPreviouslyBookedCandidateAdvancedSearchQueryFields[]
      - `or` AgencyPreviouslyBookedCandidateAdvancedSearchQueryFields[]
      - `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
      - `organisation_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
      - `site_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
      - `site_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
      - `ward_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
      - `ward_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
      - `candidate_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
      - `candidate_full_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
      - `candidate_type` 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
      - `candidate_status` AdvancedSearchCurrentStatusQueryFields
        - `status` 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_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
        - `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[]
      - `candidate_type_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_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
      - `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
      - `booking_count` AdvancedSearchOperationsNumberField
        - `equal` number, nullable
        - `greater_than` number, nullable
        - `less_than` number, nullable
        - `greater_than_equal` number, nullable
        - `less_than_equal` number, nullable
        - `in` number[]
        - `nin` number[]
      - `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
      - `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
      - `compliance_contract_status` 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
      - `last_shift_worked_at` 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[]
      - `next_shift_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[]
      - `currently_excluded` AdvancedSearchOperationsBooleanField
        - `equal` boolean
      - `compliant` AdvancedSearchOperationsBooleanField
        - `equal` boolean
      - `availability_last_updated_at` 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[]
      - `available` object
        - `status` 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
        - `period` 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
        - `range_start` AdvancedSearchOperationsDateWithoutTimeField
          - `equal` string, date, nullable
          - `greater_than` string, date, nullable
          - `less_than` string, date, nullable
          - `greater_than_equal` string, date, nullable
          - `less_than_equal` string, date, nullable
          - `in` string[]
        - `range_end` AdvancedSearchOperationsDateWithoutTimeField
          - `equal` string, date, nullable
          - `greater_than` string, date, nullable
          - `less_than` string, date, nullable
          - `greater_than_equal` string, date, nullable
          - `less_than_equal` string, date, nullable
          - `in` string[]
        - `contains` object[]
          - `status` 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
          - `period` 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
          - `range_start` AdvancedSearchOperationsDateWithoutTimeField
            - `equal` string, date, nullable
            - `greater_than` string, date, nullable
            - `less_than` string, date, nullable
            - `greater_than_equal` string, date, nullable
            - `less_than_equal` string, date, nullable
            - `in` string[]
          - `range_end` AdvancedSearchOperationsDateWithoutTimeField
            - `equal` string, date, nullable
            - `greater_than` string, date, nullable
            - `less_than` string, date, nullable
            - `greater_than_equal` string, date, nullable
            - `less_than_equal` string, date, nullable
            - `in` string[]
        - `contains_any` object[]
          - `status` 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
          - `period` 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
          - `range_start` AdvancedSearchOperationsDateWithoutTimeField
            - `equal` string, date, nullable
            - `greater_than` string, date, nullable
            - `less_than` string, date, nullable
            - `greater_than_equal` string, date, nullable
            - `less_than_equal` string, date, nullable
            - `in` string[]
          - `range_end` AdvancedSearchOperationsDateWithoutTimeField
            - `equal` string, date, nullable
            - `greater_than` string, date, nullable
            - `less_than` string, date, nullable
            - `greater_than_equal` string, date, nullable
            - `less_than_equal` string, date, nullable
            - `in` string[]
  - `project` object, required
    - `agency_id` 1, required
    - `organisation_id` 1, required
    - `site_id` 1, required
    - `site_name` 1, required
    - `ward_id` 1, required
    - `ward_name` 1, required
    - `candidate_id` 1, required
    - `candidate_full_name` 1, required
    - `job_title_id` 1, required
    - `job_title_name` 1, required
    - `job_family_id` 1
    - `job_family_name` 1
    - `booking_count` 1, required
    - `considered_shifts` 1
    - `advanced_search_agency_client_no_collation_id` 1
    - `compliance_contract_id` 1
    - `compliance_contract_link_id` 1
    - `last_shift_worked_at` 1
    - `next_shift_date` 1
    - `candidate_type` 1
    - `candidate_type_id` 1
    - `candidate_status` 1
    - `compliance_contract_status` 1
    - `currently_excluded` 1
    - `exclusions` 1
    - `compliant` 1
    - `compliance_contract` 1
    - `availability_last_updated_at` 1
    - `available` 1
    - `created_at` 1
    - `updated_at` 1
    - `__v` 1

## Response `200`

list of agency previously booked candidates based on search criteria

- AgencyPreviouslyBookedCandidateAdvancedSearchResult[]
  - `_id` string
  - `agency_id` string
  - `organisation_id` string
  - `site_id` string
  - `site_name` string
  - `ward_id` string
  - `ward_name` string
  - `candidate_id` string
  - `candidate_full_name` string
  - `job_title_id` string
  - `job_title_name` string
  - `job_family_id` string
  - `job_family_name` string
  - `booking_count` integer
  - `considered_shifts` object[]
    - `shift_id` string
    - `advanced_search_agency_shift_id` string
  - `advanced_search_agency_client_no_collation_id` string
  - `compliance_contract_id` string
  - `compliance_contract_link_id` string
  - `last_shift_worked_at` string, date-time
  - `next_shift_date` string, date-time
  - `candidate_type` string
  - `candidate_type_id` string
  - `candidate_status` object
    - `status` string
    - `status_id` string
    - `date` string, date-time
  - `compliance_contract_status` string
  - `currently_excluded` boolean
  - `exclusions` string[]
  - `compliant` boolean
  - `compliance_contract` object[]
    - `contract_id` string
    - `contract_output` integer
  - `availability_last_updated_at` string, date-time
  - `available` object[]
    - `status` string
    - `period` string
    - `range_start` string, date-time
    - `range_end` string, date-time
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `__v` integer

## Other responses

- `204`: No content
- `400`: Validation Error. Usually caused by a missing or invalid parameter.
- `401`: Failed to authenticate the user making the request
- `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)