---
title: "Search everything"
method: GET
path: "/search"
tags: ["search"]
---

# Search everything

`GET /search`

Searches all sheets that the user can access, for the specified text.

> **Important:** If you have't used the public API in a while, we will need to provision your data. This could take up to 24 hours so please check back later!

## Query parameters

- `query` string, required
- `location` string
- `modifiedSince` union
  - string, date-time
  - number
- `include` 'favoriteFlag'
- `scopes` string[]

## Response `200`

Object that contains an array of matching items and the total count of those items.

- SearchResult
  - `results` union[] — Array of matching items.
    - union
      - SearchResultItem — Represents an item that matches the search query.
        - `text` string — Excerpt of the item's matching text.
        - `objectType` 'attachment' | 'sight' | 'discussion' | 'folder' | 'report' | 'row' | 'sheet' | 'summaryField' | 'template' | 'workspace' — The matching item's type.
        - `objectId` number — The matching item's ID.
        - `contextData` string[] — Additional information about the matching item. If the item has a discussion or attachment belonging to a proof, the context data includes the URL of that proof (for example, `"proofUrl: https://app.smartsheet.com/b/proofs/sheets/abc123/proofs/def456"`).
        - `favorite` boolean — `true` if the item is one of the user's favorites.
      - SearchResultSubItem — Represents an item that matches the search query and is a sub-component of another item. For example, a row is a sub-component of a sheet. Both are items that can match a search query.
        - `text` string — Excerpt of the item's matching text.
        - `objectType` 'attachment' | 'sight' | 'discussion' | 'folder' | 'report' | 'row' | 'sheet' | 'summaryField' | 'template' | 'workspace' — The matching item's type.
        - `objectId` number — The matching item's ID.
        - `contextData` string[] — Additional information about the matching item. If the item has a discussion or attachment belonging to a proof, the context data includes the URL of that proof (for example, `"proofUrl: https://app.smartsheet.com/b/proofs/sheets/abc123/proofs/def456"`).
        - `parentObjectType` 'dashboard' | 'folder' | 'report' | 'sheet' | 'template' | 'workspace' — The type of the item's parent.
        - `parentObjectId` number — The ID of the item's parent.
        - `parentObjectName` string — The name of the item's parent.
        - `parentObjectFavorite` boolean — `true` if the parent is one of the user's favorites.
  - `totalCount` number — Total number of search results in the `results` array.

## Other responses

- `default` — Generic Error Payload

---

[API](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/smartsheet-openapi-reference/versions/b4afda95fb51/schema)