---
title: "Search boxes, contacts, and organizations"
method: GET
path: "/v1/search"
tags: ["Search"]
---

# Search boxes, contacts, and organizations

`GET /v1/search`

## Request

- Base URL: `https://api.streak.com/api`
- URL: `https://api.streak.com/api/v1/search`
- Auth: HTTP bearer

Searches visible boxes, contacts, and organizations by query, or visible boxes by exact name. Exactly one of query or name must be provided.

## Query parameters

- `name` string, nullable
- `page` integer
- `pipelineKey` string[], nullable
- `query` string, nullable
- `stageKey` string[], nullable
- `teamKey` string[], nullable

## Response `200`

OK

- SearchResponse: Response returned by the legacy v1 search endpoint.
  - `results` SearchResults, required: Search results grouped by legacy result collection name.
    - `boxes` SearchBoxResult[], required: Matching boxes.
      - `boxKey` string, required: Key for the matching box.
      - `name` string, nullable: Box name.
      - `lastUpdatedTimestamp` integer: Timestamp when the box was last updated, in epoch milliseconds.
      - `assignedToKeys` string[], nullable: User keys assigned to the box.
      - `stageKey` string, nullable: Current stage key for the box.
      - `pipelineKey` string, nullable: Pipeline key for the box.
    - `contacts` SearchContactResult[], required: Matching contacts.
      - `givenName` string, nullable: Contact given name.
      - `familyName` string, nullable: Contact family name.
      - `other` string, nullable: Contact display name or other indexed text.
      - `key` string, nullable: Key for the matching contact.
      - `title` string, nullable: Contact title.
      - `addresses` string[], nullable: Contact street addresses.
      - `emailAddresses` string[], nullable: Contact email addresses.
      - `phoneNumbers` string[], nullable: Contact phone numbers.
    - `orgs` SearchOrganizationResult[], required: Matching organizations.
      - `name` string, nullable: Organization name.
      - `other` string, nullable: Organization display name or other indexed text.
      - `key` string, nullable: Key for the matching organization.
      - `industry` string, nullable: Organization industry.
      - `employeeCount` string, nullable: Organization employee count label.
      - `logoURL` string, nullable: Organization logo URL.
      - `normalizedDomains` string[], nullable: Normalized organization domains.
      - `domains` string[], nullable: Organization domains.
      - `addresses` string[], nullable: Organization street addresses.
  - `query` string, nullable: The query string used for full-text searches. Null when searching by exact box name.
  - `page` integer: Zero-based page number returned by the search.

## Changes

- **2026-10-16** `1c3a5ef8b9ea`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/streakyc/apis/streak/changes/v1/search/get.md)

---

[API](https://skmtc.dev/streakyc/apis/streak.md) - [All operations](https://skmtc.dev/streakyc/apis/streak/llms.txt) - [OpenAPI document](https://skmtc.dev/streakyc/apis/streak/revisions/3648671fd1cf?raw)