---
title: "Discover active handovers"
method: GET
path: "/handovers"
---

# Discover active handovers

`GET /handovers`

## Request

- Base URL: `https://handover.sh/api/v1`
- URL: `https://handover.sh/api/v1/handovers`
- Auth: HTTP bearer

## Query parameters

- `q` string
- `mode` 'hybrid' | 'semantic' | 'lexical'
- `limit` integer
- `cursor` string
- `status` 'active' | 'archived' | 'trashed'

## Response `200`

A page of handovers

- HandoverPageEnvelope
  - `data` object, required
    - `items` Handover[], required
      - `id` string, required
      - `title` string, required
      - `summary` string
      - `status` 'active' | 'archived' | 'trashed', required
      - `visibility` 'workspace' | 'restricted', required
      - `deletedAt` string, date-time, nullable, required
      - `purgeAfter` string, date-time, nullable, required
      - `currentRevisionId` string, required
      - `currentRevision` object, required
      - `revisions` object[], required
    - `nextCursor` string, nullable, required
    - `modeRequested` 'hybrid' | 'semantic' | 'lexical'
    - `modeUsed` 'hybrid' | 'semantic' | 'lexical'
    - `semanticAvailable` boolean

---

[API](https://skmtc.dev/handover/apis/handover-api.md) · [All operations](https://skmtc.dev/handover/apis/handover-api/llms.txt) · [OpenAPI document](https://skmtc.dev/handover/apis/handover-api/revisions/846b2a3091df?raw)