Companies API: Search

Endpoint#

Property	Value
Type	query
Method	GET
Path	/api/external/v1/companies/search
Handler	OperatelyWeb.Api.Companies.Search

Authentication#

• Requires a valid API token.
• Read-only and full-access tokens can execute this query.

Inputs#

Field	Type	Required	Nullable	Default
query	string	Yes	No	-
space_ids	array of id primitive (encoded as string)	No	Yes	-
types	array of search_result_type enum (resource_hub_folder, resource_hub_document, resource_hub_file, resource_hub_link, project, goal, milestone, task, person, discussion, project_check_in, goal_check_in, project_retrospective)	No	Yes	-
time_range	search_time_range enum (last_7_days, last_30_days, last_90_days, last_12_months)	No	Yes	-
sort	search_sort enum (best_match, most_recent)	No	Yes	-

Outputs#

Field	Type	Required	Nullable
results	array of search_result object	Yes	No

cURL Example#

Copied

curl --request GET \
  --url "https://app.operately.com/api/external/v1/companies/search?query=value&sort=best_match&space_ids[]=value&time_range=last_7_days&types[]=resource_hub_folder" \
  --header "Authorization: Bearer ${OPERATELY_API_TOKEN}"

Response Example#

{
  "results": [
    {
      "__typename": "value",
      "context": "value",
      "id": "value",
      "inserted_at": "2026-01-01T09:30:00Z",
      "matched_field": "title",
      "navigation_target": "<search_navigation_target>",
      "snippet": "value",
      "state": "closed",
      "title": "value",
      "type": "resource_hub_folder"
    }
  ]
}