Search jobs
curl --request POST \
--url https://api.stardex.ai/v1/jobs/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"offset": 0,
"limit": 200,
"sort_by": "<string>",
"sort_order": "desc",
"keywords": [
"<string>"
],
"location_keywords": [
"<string>"
],
"vector_search": "<string>",
"is_archived": true,
"job_status_ids_included": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"job_status_ids_excluded": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"company_ids_included": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"company_ids_excluded": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"owner_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"team_member_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"team_member_role_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"is_public": true,
"created_at_gte": "2023-11-07T05:31:56Z",
"created_at_lte": "2023-11-07T05:31:56Z",
"updated_at_gte": "2023-11-07T05:31:56Z",
"updated_at_lte": "2023-11-07T05:31:56Z",
"list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"select_attribute_filters": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"values": [],
"excluded_values": [],
"require_all": false,
"include_empty": false
}
],
"numeric_attribute_filters": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"min": 123,
"max": 123,
"include_empty": false
}
],
"date_attribute_filters": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"start_date": "<string>",
"end_date": "<string>",
"include_empty": false
}
],
"team_member_attribute_filters": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"values": [],
"excluded_values": [],
"require_all": false,
"include_empty": false
}
],
"include": []
}
'import requests
url = "https://api.stardex.ai/v1/jobs/search"
payload = {
"offset": 0,
"limit": 200,
"sort_by": "<string>",
"sort_order": "desc",
"keywords": ["<string>"],
"location_keywords": ["<string>"],
"vector_search": "<string>",
"is_archived": True,
"job_status_ids_included": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"job_status_ids_excluded": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"company_ids_included": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"company_ids_excluded": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"owner_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"team_member_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"team_member_role_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"is_public": True,
"created_at_gte": "2023-11-07T05:31:56Z",
"created_at_lte": "2023-11-07T05:31:56Z",
"updated_at_gte": "2023-11-07T05:31:56Z",
"updated_at_lte": "2023-11-07T05:31:56Z",
"list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"select_attribute_filters": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"values": [],
"excluded_values": [],
"require_all": False,
"include_empty": False
}
],
"numeric_attribute_filters": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"min": 123,
"max": 123,
"include_empty": False
}
],
"date_attribute_filters": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"start_date": "<string>",
"end_date": "<string>",
"include_empty": False
}
],
"team_member_attribute_filters": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"values": [],
"excluded_values": [],
"require_all": False,
"include_empty": False
}
],
"include": []
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
offset: 0,
limit: 200,
sort_by: '<string>',
sort_order: 'desc',
keywords: ['<string>'],
location_keywords: ['<string>'],
vector_search: '<string>',
is_archived: true,
job_status_ids_included: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
job_status_ids_excluded: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
company_ids_included: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
company_ids_excluded: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
owner_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
team_member_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
team_member_role_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
is_public: true,
created_at_gte: '2023-11-07T05:31:56Z',
created_at_lte: '2023-11-07T05:31:56Z',
updated_at_gte: '2023-11-07T05:31:56Z',
updated_at_lte: '2023-11-07T05:31:56Z',
list_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
select_attribute_filters: [
{
attribute_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
values: [],
excluded_values: [],
require_all: false,
include_empty: false
}
],
numeric_attribute_filters: [
{
attribute_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
min: 123,
max: 123,
include_empty: false
}
],
date_attribute_filters: [
{
attribute_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
start_date: '<string>',
end_date: '<string>',
include_empty: false
}
],
team_member_attribute_filters: [
{
attribute_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
values: [],
excluded_values: [],
require_all: false,
include_empty: false
}
],
include: []
})
};
fetch('https://api.stardex.ai/v1/jobs/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.stardex.ai/v1/jobs/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'offset' => 0,
'limit' => 200,
'sort_by' => '<string>',
'sort_order' => 'desc',
'keywords' => [
'<string>'
],
'location_keywords' => [
'<string>'
],
'vector_search' => '<string>',
'is_archived' => true,
'job_status_ids_included' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'job_status_ids_excluded' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'company_ids_included' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'company_ids_excluded' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'owner_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'team_member_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'team_member_role_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'is_public' => true,
'created_at_gte' => '2023-11-07T05:31:56Z',
'created_at_lte' => '2023-11-07T05:31:56Z',
'updated_at_gte' => '2023-11-07T05:31:56Z',
'updated_at_lte' => '2023-11-07T05:31:56Z',
'list_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'select_attribute_filters' => [
[
'attribute_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'values' => [
],
'excluded_values' => [
],
'require_all' => false,
'include_empty' => false
]
],
'numeric_attribute_filters' => [
[
'attribute_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'min' => 123,
'max' => 123,
'include_empty' => false
]
],
'date_attribute_filters' => [
[
'attribute_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'start_date' => '<string>',
'end_date' => '<string>',
'include_empty' => false
]
],
'team_member_attribute_filters' => [
[
'attribute_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'values' => [
],
'excluded_values' => [
],
'require_all' => false,
'include_empty' => false
]
],
'include' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.stardex.ai/v1/jobs/search"
payload := strings.NewReader("{\n \"offset\": 0,\n \"limit\": 200,\n \"sort_by\": \"<string>\",\n \"sort_order\": \"desc\",\n \"keywords\": [\n \"<string>\"\n ],\n \"location_keywords\": [\n \"<string>\"\n ],\n \"vector_search\": \"<string>\",\n \"is_archived\": true,\n \"job_status_ids_included\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"job_status_ids_excluded\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"company_ids_included\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"company_ids_excluded\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"owner_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"team_member_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"team_member_role_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"is_public\": true,\n \"created_at_gte\": \"2023-11-07T05:31:56Z\",\n \"created_at_lte\": \"2023-11-07T05:31:56Z\",\n \"updated_at_gte\": \"2023-11-07T05:31:56Z\",\n \"updated_at_lte\": \"2023-11-07T05:31:56Z\",\n \"list_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"select_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"values\": [],\n \"excluded_values\": [],\n \"require_all\": false,\n \"include_empty\": false\n }\n ],\n \"numeric_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"min\": 123,\n \"max\": 123,\n \"include_empty\": false\n }\n ],\n \"date_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"start_date\": \"<string>\",\n \"end_date\": \"<string>\",\n \"include_empty\": false\n }\n ],\n \"team_member_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"values\": [],\n \"excluded_values\": [],\n \"require_all\": false,\n \"include_empty\": false\n }\n ],\n \"include\": []\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.stardex.ai/v1/jobs/search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"offset\": 0,\n \"limit\": 200,\n \"sort_by\": \"<string>\",\n \"sort_order\": \"desc\",\n \"keywords\": [\n \"<string>\"\n ],\n \"location_keywords\": [\n \"<string>\"\n ],\n \"vector_search\": \"<string>\",\n \"is_archived\": true,\n \"job_status_ids_included\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"job_status_ids_excluded\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"company_ids_included\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"company_ids_excluded\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"owner_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"team_member_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"team_member_role_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"is_public\": true,\n \"created_at_gte\": \"2023-11-07T05:31:56Z\",\n \"created_at_lte\": \"2023-11-07T05:31:56Z\",\n \"updated_at_gte\": \"2023-11-07T05:31:56Z\",\n \"updated_at_lte\": \"2023-11-07T05:31:56Z\",\n \"list_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"select_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"values\": [],\n \"excluded_values\": [],\n \"require_all\": false,\n \"include_empty\": false\n }\n ],\n \"numeric_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"min\": 123,\n \"max\": 123,\n \"include_empty\": false\n }\n ],\n \"date_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"start_date\": \"<string>\",\n \"end_date\": \"<string>\",\n \"include_empty\": false\n }\n ],\n \"team_member_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"values\": [],\n \"excluded_values\": [],\n \"require_all\": false,\n \"include_empty\": false\n }\n ],\n \"include\": []\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.stardex.ai/v1/jobs/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"offset\": 0,\n \"limit\": 200,\n \"sort_by\": \"<string>\",\n \"sort_order\": \"desc\",\n \"keywords\": [\n \"<string>\"\n ],\n \"location_keywords\": [\n \"<string>\"\n ],\n \"vector_search\": \"<string>\",\n \"is_archived\": true,\n \"job_status_ids_included\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"job_status_ids_excluded\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"company_ids_included\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"company_ids_excluded\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"owner_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"team_member_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"team_member_role_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"is_public\": true,\n \"created_at_gte\": \"2023-11-07T05:31:56Z\",\n \"created_at_lte\": \"2023-11-07T05:31:56Z\",\n \"updated_at_gte\": \"2023-11-07T05:31:56Z\",\n \"updated_at_lte\": \"2023-11-07T05:31:56Z\",\n \"list_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"select_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"values\": [],\n \"excluded_values\": [],\n \"require_all\": false,\n \"include_empty\": false\n }\n ],\n \"numeric_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"min\": 123,\n \"max\": 123,\n \"include_empty\": false\n }\n ],\n \"date_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"start_date\": \"<string>\",\n \"end_date\": \"<string>\",\n \"include_empty\": false\n }\n ],\n \"team_member_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"values\": [],\n \"excluded_values\": [],\n \"require_all\": false,\n \"include_empty\": false\n }\n ],\n \"include\": []\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Senior Software Engineer",
"created_at": "2024-01-10T09:00:00Z",
"is_archived": false,
"client_company_name": "StartupXYZ",
"client_company_id": "456e7890-e12b-34d5-a678-901234567890",
"client_company_domain": "startupxyz.com",
"client_company_linkedin_url": "https://www.linkedin.com/company/startupxyz",
"job_status_name": "Active",
"job_status_id": "789e0123-e45f-67a8-b901-234567890123",
"candidate_count": 12,
"location": "San Francisco, CA",
"primary_url": "https://startupxyz.com/careers/senior-swe",
"job_function": "Engineering",
"open_date": "2024-01-01",
"end_date": null,
"currency_code": "USD",
"salary_range": "[150000,200000]",
"salary_min": 150000,
"salary_max": 200000,
"salary_details": "+ 0.5% equity, signing bonus negotiable",
"billing_contact_name": "Sarah Chen",
"billing_contact_email": "sarah.chen@startupxyz.com",
"fee": 25000,
"description": "We are looking for a Senior Software Engineer to join our platform team...",
"team_members": [
{
"team_member_id": "234e5678-e90a-12b3-c456-789012345678",
"email": "jane@company.com",
"first_name": "Jane",
"last_name": "Smith",
"role_id": "345e6789-e01b-23c4-d567-890123456789",
"role_name": "Team Lead"
},
{
"team_member_id": "345e6789-f01b-23c4-d567-890123456789",
"email": "bob@company.com",
"first_name": "Bob",
"last_name": "Johnson",
"role_id": "456e7890-f12b-34d5-e678-901234567890",
"role_name": "Executive Sponsor"
}
],
"linked_deals": [
{
"deal_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"deal_job_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"name": "StartupXYZ — Senior SWE retained search",
"amount": 35000,
"currency_code": "USD",
"deal_status_id": "7201a0b8-e63c-4d8f-899d-78cdd62b5c38",
"deal_status_name": "Qualified",
"deal_status_color": "#10B981"
}
],
"fees": {
"retainer": {
"id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
"fee_type": "percentage",
"fee_base": "first_year_salary",
"fee_percentage": 25,
"projected_fee": 50000,
"estimated_compensation": 200000,
"installment_count": 3,
"final_payment_type": "on_placement",
"currency_code": "USD"
},
"fee_events": [
{
"id": "f6a7b8c9-d0e1-2345-f012-456789012345",
"type": "retainer",
"label": "Engagement fee",
"amount": 16666.67,
"total_fee": 50000,
"currency_code": "USD",
"fee_type": "percentage",
"fee_percentage": 25,
"compensation": 200000,
"firm_commission_percent": 100,
"is_placeholder": false,
"sequence": 1,
"start_date": "2024-01-05",
"expected_date": "2024-01-10",
"actual_payment_date": "2024-01-11",
"candidate_id": null,
"offer_id": null,
"retainer_id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
"fee_status_id": "a7b8c9d0-e1f2-3456-0123-567890123456",
"fee_status_name": "Paid",
"fee_status_color": "#10B981",
"fee_status_type": "paid"
},
{
"id": "b8c9d0e1-f2a3-4567-1234-678901234567",
"type": "placement",
"label": "Placement — Jane Smith",
"amount": 50000,
"total_fee": 50000,
"currency_code": "USD",
"fee_type": "percentage",
"fee_percentage": 25,
"compensation": 200000,
"firm_commission_percent": 100,
"is_placeholder": false,
"sequence": null,
"start_date": null,
"expected_date": "2024-03-15",
"actual_payment_date": null,
"candidate_id": "234e5678-e90a-12b3-c456-789012345678",
"offer_id": "c9d0e1f2-a3b4-5678-2345-789012345678",
"retainer_id": null,
"fee_status_id": "d0e1f2a3-b4c5-6789-3456-890123456789",
"fee_status_name": "Invoiced",
"fee_status_color": "#3B82F6",
"fee_status_type": "invoiced"
}
],
"total_placement_fee": 50000
},
"custom_fields": [
{
"attribute_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"attribute_name": "Priority",
"data_type": "single-select",
"value": null,
"tag": {
"id": "d4e5f6a7-b8c9-0123-defg-234567890123",
"name": "High"
},
"team_member": null
}
]
}
],
"meta": {
"total": 25,
"offset": 0,
"limit": 200
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}Jobs
Search jobs
Advanced job search with filtering, sorting, and vector search. Supports all filter types: keywords, location, job status, companies, team members/roles, custom attributes (select, numeric, date, team member), and semantic vector search.
AI AGENTS — Use vector_search if the user is inquiring about roles by title or title and company. Do not use keywords.
Job titles have many equivalent forms (“VP of Engineering”, “VP Engineering”, “Engineering VP”, “Head of Engineering”) — keywords will silently miss them . Vector search handles all variants automatically.
The exception: a verbatim job ID/code lookup where you need an exact internal reference (e.g. “find the jobID 1234”).
Archive filter (is_archived): Omit to include both active and archived jobs (recommended for similar past searches, comps, pitch prep, company/sector history). Pass false for active jobs only; true for archived only. Always surface archive/status in answers.
Vector search: Pass vector_search with a text query (min 5 chars) for AI-powered semantic search.
Date range filters: Use created_at_gte/created_at_lte and updated_at_gte/updated_at_lte to filter by creation or modification timestamps.
Custom attribute filters: Use select_attribute_filters, numeric_attribute_filters, date_attribute_filters, team_member_attribute_filters for custom field filtering.
Include control: Pass include: ["custom_fields", "linked_deals", "fees"] to embed custom field values, linked deals, and/or fee & placement data in each job. For API-key callers, linked_deals requires deals:read and fees requires compensation:read; inaccessible sections are omitted.
AI AGENTS — Result processing: After receiving results, reason and process them before presenting to the user. Only show jobs where the title genuinely matches what the user asked for. For example, if the user asks for “VP of Engineering” roles, exclude results like “VP Consumer Electronics” or “SVP Sales Engineering” — these are not engineering leadership roles. Show relevant results rather than regurgitating everything the vector search returns.
POST
/
v1
/
jobs
/
search
Search jobs
curl --request POST \
--url https://api.stardex.ai/v1/jobs/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"offset": 0,
"limit": 200,
"sort_by": "<string>",
"sort_order": "desc",
"keywords": [
"<string>"
],
"location_keywords": [
"<string>"
],
"vector_search": "<string>",
"is_archived": true,
"job_status_ids_included": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"job_status_ids_excluded": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"company_ids_included": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"company_ids_excluded": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"owner_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"team_member_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"team_member_role_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"is_public": true,
"created_at_gte": "2023-11-07T05:31:56Z",
"created_at_lte": "2023-11-07T05:31:56Z",
"updated_at_gte": "2023-11-07T05:31:56Z",
"updated_at_lte": "2023-11-07T05:31:56Z",
"list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"select_attribute_filters": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"values": [],
"excluded_values": [],
"require_all": false,
"include_empty": false
}
],
"numeric_attribute_filters": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"min": 123,
"max": 123,
"include_empty": false
}
],
"date_attribute_filters": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"start_date": "<string>",
"end_date": "<string>",
"include_empty": false
}
],
"team_member_attribute_filters": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"values": [],
"excluded_values": [],
"require_all": false,
"include_empty": false
}
],
"include": []
}
'import requests
url = "https://api.stardex.ai/v1/jobs/search"
payload = {
"offset": 0,
"limit": 200,
"sort_by": "<string>",
"sort_order": "desc",
"keywords": ["<string>"],
"location_keywords": ["<string>"],
"vector_search": "<string>",
"is_archived": True,
"job_status_ids_included": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"job_status_ids_excluded": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"company_ids_included": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"company_ids_excluded": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"owner_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"team_member_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"team_member_role_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"is_public": True,
"created_at_gte": "2023-11-07T05:31:56Z",
"created_at_lte": "2023-11-07T05:31:56Z",
"updated_at_gte": "2023-11-07T05:31:56Z",
"updated_at_lte": "2023-11-07T05:31:56Z",
"list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"select_attribute_filters": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"values": [],
"excluded_values": [],
"require_all": False,
"include_empty": False
}
],
"numeric_attribute_filters": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"min": 123,
"max": 123,
"include_empty": False
}
],
"date_attribute_filters": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"start_date": "<string>",
"end_date": "<string>",
"include_empty": False
}
],
"team_member_attribute_filters": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"values": [],
"excluded_values": [],
"require_all": False,
"include_empty": False
}
],
"include": []
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
offset: 0,
limit: 200,
sort_by: '<string>',
sort_order: 'desc',
keywords: ['<string>'],
location_keywords: ['<string>'],
vector_search: '<string>',
is_archived: true,
job_status_ids_included: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
job_status_ids_excluded: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
company_ids_included: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
company_ids_excluded: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
owner_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
team_member_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
team_member_role_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
is_public: true,
created_at_gte: '2023-11-07T05:31:56Z',
created_at_lte: '2023-11-07T05:31:56Z',
updated_at_gte: '2023-11-07T05:31:56Z',
updated_at_lte: '2023-11-07T05:31:56Z',
list_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
select_attribute_filters: [
{
attribute_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
values: [],
excluded_values: [],
require_all: false,
include_empty: false
}
],
numeric_attribute_filters: [
{
attribute_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
min: 123,
max: 123,
include_empty: false
}
],
date_attribute_filters: [
{
attribute_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
start_date: '<string>',
end_date: '<string>',
include_empty: false
}
],
team_member_attribute_filters: [
{
attribute_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
values: [],
excluded_values: [],
require_all: false,
include_empty: false
}
],
include: []
})
};
fetch('https://api.stardex.ai/v1/jobs/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.stardex.ai/v1/jobs/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'offset' => 0,
'limit' => 200,
'sort_by' => '<string>',
'sort_order' => 'desc',
'keywords' => [
'<string>'
],
'location_keywords' => [
'<string>'
],
'vector_search' => '<string>',
'is_archived' => true,
'job_status_ids_included' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'job_status_ids_excluded' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'company_ids_included' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'company_ids_excluded' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'owner_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'team_member_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'team_member_role_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'is_public' => true,
'created_at_gte' => '2023-11-07T05:31:56Z',
'created_at_lte' => '2023-11-07T05:31:56Z',
'updated_at_gte' => '2023-11-07T05:31:56Z',
'updated_at_lte' => '2023-11-07T05:31:56Z',
'list_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'select_attribute_filters' => [
[
'attribute_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'values' => [
],
'excluded_values' => [
],
'require_all' => false,
'include_empty' => false
]
],
'numeric_attribute_filters' => [
[
'attribute_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'min' => 123,
'max' => 123,
'include_empty' => false
]
],
'date_attribute_filters' => [
[
'attribute_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'start_date' => '<string>',
'end_date' => '<string>',
'include_empty' => false
]
],
'team_member_attribute_filters' => [
[
'attribute_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'values' => [
],
'excluded_values' => [
],
'require_all' => false,
'include_empty' => false
]
],
'include' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.stardex.ai/v1/jobs/search"
payload := strings.NewReader("{\n \"offset\": 0,\n \"limit\": 200,\n \"sort_by\": \"<string>\",\n \"sort_order\": \"desc\",\n \"keywords\": [\n \"<string>\"\n ],\n \"location_keywords\": [\n \"<string>\"\n ],\n \"vector_search\": \"<string>\",\n \"is_archived\": true,\n \"job_status_ids_included\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"job_status_ids_excluded\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"company_ids_included\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"company_ids_excluded\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"owner_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"team_member_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"team_member_role_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"is_public\": true,\n \"created_at_gte\": \"2023-11-07T05:31:56Z\",\n \"created_at_lte\": \"2023-11-07T05:31:56Z\",\n \"updated_at_gte\": \"2023-11-07T05:31:56Z\",\n \"updated_at_lte\": \"2023-11-07T05:31:56Z\",\n \"list_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"select_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"values\": [],\n \"excluded_values\": [],\n \"require_all\": false,\n \"include_empty\": false\n }\n ],\n \"numeric_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"min\": 123,\n \"max\": 123,\n \"include_empty\": false\n }\n ],\n \"date_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"start_date\": \"<string>\",\n \"end_date\": \"<string>\",\n \"include_empty\": false\n }\n ],\n \"team_member_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"values\": [],\n \"excluded_values\": [],\n \"require_all\": false,\n \"include_empty\": false\n }\n ],\n \"include\": []\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.stardex.ai/v1/jobs/search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"offset\": 0,\n \"limit\": 200,\n \"sort_by\": \"<string>\",\n \"sort_order\": \"desc\",\n \"keywords\": [\n \"<string>\"\n ],\n \"location_keywords\": [\n \"<string>\"\n ],\n \"vector_search\": \"<string>\",\n \"is_archived\": true,\n \"job_status_ids_included\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"job_status_ids_excluded\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"company_ids_included\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"company_ids_excluded\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"owner_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"team_member_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"team_member_role_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"is_public\": true,\n \"created_at_gte\": \"2023-11-07T05:31:56Z\",\n \"created_at_lte\": \"2023-11-07T05:31:56Z\",\n \"updated_at_gte\": \"2023-11-07T05:31:56Z\",\n \"updated_at_lte\": \"2023-11-07T05:31:56Z\",\n \"list_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"select_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"values\": [],\n \"excluded_values\": [],\n \"require_all\": false,\n \"include_empty\": false\n }\n ],\n \"numeric_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"min\": 123,\n \"max\": 123,\n \"include_empty\": false\n }\n ],\n \"date_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"start_date\": \"<string>\",\n \"end_date\": \"<string>\",\n \"include_empty\": false\n }\n ],\n \"team_member_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"values\": [],\n \"excluded_values\": [],\n \"require_all\": false,\n \"include_empty\": false\n }\n ],\n \"include\": []\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.stardex.ai/v1/jobs/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"offset\": 0,\n \"limit\": 200,\n \"sort_by\": \"<string>\",\n \"sort_order\": \"desc\",\n \"keywords\": [\n \"<string>\"\n ],\n \"location_keywords\": [\n \"<string>\"\n ],\n \"vector_search\": \"<string>\",\n \"is_archived\": true,\n \"job_status_ids_included\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"job_status_ids_excluded\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"company_ids_included\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"company_ids_excluded\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"owner_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"team_member_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"team_member_role_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"is_public\": true,\n \"created_at_gte\": \"2023-11-07T05:31:56Z\",\n \"created_at_lte\": \"2023-11-07T05:31:56Z\",\n \"updated_at_gte\": \"2023-11-07T05:31:56Z\",\n \"updated_at_lte\": \"2023-11-07T05:31:56Z\",\n \"list_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"select_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"values\": [],\n \"excluded_values\": [],\n \"require_all\": false,\n \"include_empty\": false\n }\n ],\n \"numeric_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"min\": 123,\n \"max\": 123,\n \"include_empty\": false\n }\n ],\n \"date_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"start_date\": \"<string>\",\n \"end_date\": \"<string>\",\n \"include_empty\": false\n }\n ],\n \"team_member_attribute_filters\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"values\": [],\n \"excluded_values\": [],\n \"require_all\": false,\n \"include_empty\": false\n }\n ],\n \"include\": []\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Senior Software Engineer",
"created_at": "2024-01-10T09:00:00Z",
"is_archived": false,
"client_company_name": "StartupXYZ",
"client_company_id": "456e7890-e12b-34d5-a678-901234567890",
"client_company_domain": "startupxyz.com",
"client_company_linkedin_url": "https://www.linkedin.com/company/startupxyz",
"job_status_name": "Active",
"job_status_id": "789e0123-e45f-67a8-b901-234567890123",
"candidate_count": 12,
"location": "San Francisco, CA",
"primary_url": "https://startupxyz.com/careers/senior-swe",
"job_function": "Engineering",
"open_date": "2024-01-01",
"end_date": null,
"currency_code": "USD",
"salary_range": "[150000,200000]",
"salary_min": 150000,
"salary_max": 200000,
"salary_details": "+ 0.5% equity, signing bonus negotiable",
"billing_contact_name": "Sarah Chen",
"billing_contact_email": "sarah.chen@startupxyz.com",
"fee": 25000,
"description": "We are looking for a Senior Software Engineer to join our platform team...",
"team_members": [
{
"team_member_id": "234e5678-e90a-12b3-c456-789012345678",
"email": "jane@company.com",
"first_name": "Jane",
"last_name": "Smith",
"role_id": "345e6789-e01b-23c4-d567-890123456789",
"role_name": "Team Lead"
},
{
"team_member_id": "345e6789-f01b-23c4-d567-890123456789",
"email": "bob@company.com",
"first_name": "Bob",
"last_name": "Johnson",
"role_id": "456e7890-f12b-34d5-e678-901234567890",
"role_name": "Executive Sponsor"
}
],
"linked_deals": [
{
"deal_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"deal_job_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"name": "StartupXYZ — Senior SWE retained search",
"amount": 35000,
"currency_code": "USD",
"deal_status_id": "7201a0b8-e63c-4d8f-899d-78cdd62b5c38",
"deal_status_name": "Qualified",
"deal_status_color": "#10B981"
}
],
"fees": {
"retainer": {
"id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
"fee_type": "percentage",
"fee_base": "first_year_salary",
"fee_percentage": 25,
"projected_fee": 50000,
"estimated_compensation": 200000,
"installment_count": 3,
"final_payment_type": "on_placement",
"currency_code": "USD"
},
"fee_events": [
{
"id": "f6a7b8c9-d0e1-2345-f012-456789012345",
"type": "retainer",
"label": "Engagement fee",
"amount": 16666.67,
"total_fee": 50000,
"currency_code": "USD",
"fee_type": "percentage",
"fee_percentage": 25,
"compensation": 200000,
"firm_commission_percent": 100,
"is_placeholder": false,
"sequence": 1,
"start_date": "2024-01-05",
"expected_date": "2024-01-10",
"actual_payment_date": "2024-01-11",
"candidate_id": null,
"offer_id": null,
"retainer_id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
"fee_status_id": "a7b8c9d0-e1f2-3456-0123-567890123456",
"fee_status_name": "Paid",
"fee_status_color": "#10B981",
"fee_status_type": "paid"
},
{
"id": "b8c9d0e1-f2a3-4567-1234-678901234567",
"type": "placement",
"label": "Placement — Jane Smith",
"amount": 50000,
"total_fee": 50000,
"currency_code": "USD",
"fee_type": "percentage",
"fee_percentage": 25,
"compensation": 200000,
"firm_commission_percent": 100,
"is_placeholder": false,
"sequence": null,
"start_date": null,
"expected_date": "2024-03-15",
"actual_payment_date": null,
"candidate_id": "234e5678-e90a-12b3-c456-789012345678",
"offer_id": "c9d0e1f2-a3b4-5678-2345-789012345678",
"retainer_id": null,
"fee_status_id": "d0e1f2a3-b4c5-6789-3456-890123456789",
"fee_status_name": "Invoiced",
"fee_status_color": "#3B82F6",
"fee_status_type": "invoiced"
}
],
"total_placement_fee": 50000
},
"custom_fields": [
{
"attribute_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"attribute_name": "Priority",
"data_type": "single-select",
"value": null,
"tag": {
"id": "d4e5f6a7-b8c9-0123-defg-234567890123",
"name": "High"
},
"team_member": null
}
]
}
],
"meta": {
"total": 25,
"offset": 0,
"limit": 200
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}Authorizations
Authenticate with a Bearer token: API key, OAuth token, or session token.
Body
application/json
Records to skip for pagination. Defaults to 0.
Required range:
x >= 0Max records to return (1–200). Defaults to 200.
Required range:
1 <= x <= 200Sort column. Values: title, company, status, fee, created_at, days_since_opened, location, total_candidates, or custom_<attribute_id>. Defaults to created_at.
Sort direction. Defaults to desc (newest first).
Available options:
asc, desc Full-text search across job title, description, location, and company name/domain.
Search specifically in the job location field.
AI semantic search query (min 5 chars). Uses vector embeddings for contextual matching.
Minimum string length:
5Filter by archive status. Omit to include both active and archived jobs (recommended for similar past searches, comps, pitch prep, and company/sector history). Pass false for active jobs only (current pipeline / open searches). Pass true for archived jobs only.
Include only jobs with these status IDs. Status IDs are returned in job list/detail responses as job_status_id.
Exclude jobs with these status IDs.
Include only jobs for these client companies. Get IDs from GET /v1/companies.
Exclude jobs for these client companies.
Filter to jobs owned by these team members (owner role). Get IDs from GET /v1/team-members.
Filter to jobs with any of these team members assigned. Get IDs from GET /v1/team-members.
Filter to jobs that have members with these roles. Get role IDs from GET /v1/jobs/team-member-roles.
Filter for publicly posted jobs only.
Filter jobs created on or after this ISO 8601 datetime (e.g. "2024-01-01T00:00:00Z").
Filter jobs created on or before this ISO 8601 datetime (e.g. "2024-12-31T23:59:59Z").
Filter jobs updated on or after this ISO 8601 datetime (e.g. "2024-01-01T00:00:00Z").
Filter jobs updated on or before this ISO 8601 datetime (e.g. "2024-12-31T23:59:59Z").
Filter to jobs in this saved list.
Filter by select/multi-select custom fields. Get attribute_id and tag IDs from GET /v1/custom-fields/jobs.
Show child attributes
Show child attributes
Filter by numeric custom fields (min/max range). Get attribute_id from GET /v1/custom-fields/jobs.
Show child attributes
Show child attributes
Filter by date custom fields (date range). Get attribute_id from GET /v1/custom-fields/jobs.
Show child attributes
Show child attributes
Filter by team-member custom fields. Get attribute_id from GET /v1/custom-fields/jobs, team member IDs from GET /v1/team-members.
Show child attributes
Show child attributes
Extra sections to embed. Values: custom_fields, linked_deals, fees. Omit for base fields only. For API-key callers, linked_deals requires deals:read and fees requires compensation:read; inaccessible sections are omitted.
Available options:
custom_fields, linked_deals, fees Was this page helpful?
⌘I