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

# Global Search

`GET /search`

## Request

- Base URL: `https://app.zeno-works.ch` (the document declares no server; this is the origin it was published from)
- URL: `https://app.zeno-works.ch/search`
- Auth: none declared

Full-text search across emails + items, ranked by ``ts_rank_cd``, scoped (A1).

``archive_status`` constrains item results only (the Documents → Archive page
passes ``archived`` so its search box never surfaces pending/triage-parked items).

## Query parameters

- `q` string, required
- `type` string, nullable
- `source` string, nullable
- `direction` string, nullable
- `archive_status` 'pending' | 'archiving' | 'archived' | 'failed'
- `company_id` string, nullable
- `limit` integer
- `offset` integer

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Response `200`

Successful Response

- SearchResponse: ``{"results": [...], "total": N}``.
  - `results` SearchResult[], required
    - `type` string, required
    - `id` string, required
    - `company_id` string, required
    - `rank` number, required
    - `snippet` string, required
    - `source` string, nullable
    - `title` string, nullable
    - `date` string, nullable
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zeno-works/apis/zeno-api.md) · [All operations](https://skmtc.dev/zeno-works/apis/zeno-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zeno-works/apis/zeno-api/revisions/1eb93dde146c?raw)