---
title: "Search across all your spaces"
method: GET
path: "/search"
---

# Search across all your spaces

`GET /search`

## Request

- Base URL: `https://api.spacecontext.app/v1`
- URL: `https://api.spacecontext.app/v1/search`
- Auth: HTTP bearer

Finds the records (items, areas, issues, key locations, instructions, facts, questions and answers) that best match a question in natural language, across every space this key can read, in any of 100+ languages: "where did I see a ladder?". Each result names its space, scan and record, so it can be opened with the other operations. The index holds only screened, redacted content: no result ever contains a sensitive value, whatever the key's scopes. A space appears once its current scan has been indexed: after a scan completes, or after the deep pass of a space scanned with the app. Test keys search the demo space, without a model. Limits: 20 a minute and, by default, 1000 a day per account.

## Query parameters

- `q` string, required
- `space_id` string
- `limit` integer

## Response `200`

Best matches first

- SearchResults
  - `object` 'search_results', required
  - `query` string, required
  - `data` object[], required
    - `space_id` string, required
    - `space_name` string, required
    - `scan_id` string, required
    - `record_type` 'area' | 'item' | 'issue' | 'key_location' | 'instruction' | 'fact' | 'qa', required
    - `record_id` string, required
    - `title` string, required
    - `area` string, nullable, required
    - `text` string, required
    - `score` number, required: Relevance; higher is better. Comparable within one response only.

## Other responses

- `400`: Error response
- `401`: Error response
- `403`: Error response
- `404`: Error response
- `429`: Too many requests. Retry after the number of seconds in `Retry-After`.
- `503`: Error response

---

[API](https://skmtc.dev/spacecontext/apis/space-context-api.md) · [All operations](https://skmtc.dev/spacecontext/apis/space-context-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spacecontext/apis/space-context-api/revisions/1dca940259b4?raw)