Skip to main content
POST
/
search
/
start-filter-search
Start Filter Search (Sync)
curl --request POST \
  --url https://api.sixtyfour.ai/search/start-filter-search \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": {},
  "simple_filters": {},
  "mode": "company",
  "max_results": 1000,
  "page_size": 10,
  "save_json": false,
  "cursor": "<string>"
}
'
{
  "total_results": 123,
  "search_id": "<string>",
  "resource_handle_id": "",
  "csv_download_url": "<string>",
  "json_download_url": "<string>",
  "next_cursor": "<string>",
  "cursor_expires_in_seconds": 123,
  "request_duration_ms": 123,
  "has_more": false,
  "page_size": 123,
  "page_count": 123,
  "page_number": 123,
  "total_pages": 123,
  "max_pages": 123,
  "remaining_results": 123,
  "download_expires_in_seconds": 123,
  "total_available": 123,
  "exported_count": 0,
  "results": [
    {}
  ],
  "parsed_query": {},
  "natural_language_query": "<string>"
}

Headers

​
x-api-key
string | null

Body

application/json

Request to start a filter-based search (no LLM step).

​
filters
Filters · object

Raw OpenSearch DSL filters.

​
simple_filters
Simple Filters · object

MongoDB-style filters that the API translates to DSL.

​
mode
enum<string>
default:company

Search mode: 'people' or 'company'.

Available options:
people,
company
​
max_results
integer
default:1000

Maximum number of results to return across pages.

​
page_size
integer
default:10

Number of results per page (1-100).

Required range: 1 <= x <= 100
​
save_json
boolean
default:false

Also save results as JSON in addition to CSV.

​
cursor
string | null

Opaque pagination cursor returned by a previous response.

Response

Successful Response

Response for a completed filter search.

​
total_results
integer
required

Rows returned so far (cumulative for company pagination).

​
search_id
string | null

Search history ID; reuse with /search/query or /search/export.

​
resource_handle_id
string
default:""

Legacy export handle. Empty for company direct-filter mode.

​
csv_download_url
string | null

Signed URL to download results as CSV.

​
json_download_url
string | null

Signed URL to download results as JSON.

​
next_cursor
string | null

Cursor to fetch the next page; null when exhausted.

​
cursor_expires_in_seconds
integer | null

Seconds until next_cursor expires.

​
request_duration_ms
integer | null

Server-side request duration in milliseconds.

​
has_more
boolean
default:false

True when another page is available via next_cursor.

​
page_size
integer | null

Number of results per page (1-100).

​
page_count
integer | null

Number of results in this response page.

​
page_number
integer | null

1-based page number (company pagination).

​
total_pages
integer | null

Final total page count; omitted while has_more is true.

​
max_pages
integer | null

Upper bound on pages based on max_results and page_size.

​
remaining_results
integer | null

Rows still available under max_results after this page.

​
download_expires_in_seconds
integer | null

Seconds until the download URLs expire.

​
total_available
integer | null

Total OpenSearch matches across pages (capped at 50000); people-mode only.

​
exported_count
integer
default:0

Legacy export count; always 0 for company direct-filter mode.

​
results
Results · object[]

Rows returned for the current page.

​
parsed_query
Parsed Query · object

Structured filter set echoed back; round-trippable into a follow-up request.

​
natural_language_query
string | null

Original natural-language query echoed verbatim, if any.