---
title: "Searches job with a specific filter or query"
method: POST
path: "/api/external/job/search"
tags: ["Job APIs"]
---

# Searches job with a specific filter or query

`POST /api/external/job/search`

<br/><a href="https://com-recruiterflow-site-static-content.s3.eu-central-1.amazonaws.com/static/resources/Job%20Search.pdf">Link</a><br/><br/><b>Note: Structure changes to {"data": [], "total_items": int} when include_count is enabled.</b><br><br/><br/><b>Please find the format of custom field input below.</b><br/>{<br/>  "conjunction": "match-all",<br/>  "current_page": 1,<br/>  "filters": [<br/>    # Please add here from below list, according to your requirements!<br/>  ],<br/>  "items_per_page": 100<br/>}<br/><br/><li> Job company:<br/>{<br/>  "conjunction": "in",<br/>  "key": "job_client_company",<br/>  "values": [4]<br/>}<br/></li><br/><br/><li> Job Department:<br/>{<br/>  "conjunction": "in",<br/>  "key": "job_department",<br/>  "values": [1]<br/>}<br/></li><br/><br/><li> Job ID:<br/>{<br/>  "conjunction": "in",<br/>  "key": "job_id",<br/>  "values": [1,2]<br/>}<br/></li><br/><br/><li> Job Name:<br/>{<br/>  "conjunction": "in",<br/>  "key": "name",<br/>  "values": ["Creator"]<br/>}<br/></li><br/><br/><li> Job Custom field long and short text:<br/>{<br/>  "conjunction": "in",<br/>  "key": "custom_field.5",<br/>  "values": ["sample_long_text"]<br/>}<br/></li><br/><br/><li> Job Custom field Multiselect/Single-select/Yes_No:<br/>{<br/>  "conjunction": "in",<br/>  "key": "custom_field.6",<br/>  "values": [4],<br/>}<br/></li><br/><br/><li> Job Custom field Date:<br/>{ "conjunction": "in",<br/>                  "key": "custom_field.12",<br/>                  "date": "2021-10-04",<br/>                  "is_relative": false,<br/>                  "filter_type": "after"<br/>                }<br/></li><br/><br/><li> Job Custom field Number <"filter_type": "more-than/less-than/equal-to/between">:<br/>{<br/>  "conjunction": "in",<br/>  "key": "custom_field.2",<br/>  "filter_type": "more-than",<br/>  "value": "10"<br/>}<br/></li><br/><br/><li> Job Custom field Number <"filter_type": "between">:<br/>{<br/>  "conjunction": "in",<br/>  "key": "custom_field.2",<br/>  "filter_type": "between",<br/>  "min_value": "22",<br/>  "max_value": "33"<br/>}<br/></li><br/><br/><li> Job Custom field Money <"filter_type": "more-than/less-than/equal-to/between">:<br/>{<br/>  "conjunction": "in",<br/>  "key": "custom_field.11",<br/>  "filter_type": "more-than",<br/>  "value": {<br/>            "currency": "INR",<br/>            "number": "22"<br/>            }<br/>}<br/></li><br/><br/> <li> Job Custom field Money <"filter_type": "between">:<br/>{<br/>  "conjunction": "in",<br/>  "key": "custom_field.11",<br/>  "filter_type": "between",<br/>  "min_value": "22",<br/>  "max_value": "33"<br/>}<br/></li><br/><br/><li> Job Custom field Money range <"type": "range">:<br/>{<br/>  "conjunction": "in",<br/>  "input": "money",<br/>  "key": "custom_field.11",<br/>  "value": {<br/>            "currency": "INR",<br/>            "number": "22"<br/>            }<br/>}<br/></li><br/><br/>

## Headers

- `RF-Api-Key` string, required
- `content-type` string

## Request body

- object
  - `conjunction` string
  - `current_page` integer
  - `filters` object[]
    - `conjunction` string
    - `date` string
    - `filter_type` string
    - `is_relative` boolean
    - `key` string
  - `include_count` boolean
  - `include_description` boolean
  - `items_per_page` integer

## Response `200`

Auto generated using Swagger Inspector

- unknown

## Changes

- **2026-08-13** `febc104d89ff` — 1 breaking
  - the `header` request parameter `RF-Api-Key` became required

[Change history](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation/changes/api/external/job/search/post.md)

---

[API](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation.md) · [All operations](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recruiterflow/recruiterflow-api-documentation/revisions/febc104d89ff/schema)