---
title: "Search lineage records across a selectable set of accessible workspaces"
method: GET
path: "/lineage/search"
tags: ["lineage"]
---

# Search lineage records across a selectable set of accessible workspaces

`GET /lineage/search`

Cross-workspace lineage search. The `q` DSL uses a simple set of
                            conventions: whitespace = AND, a comma inside a qualifier = OR, and
                            repeating a qualifier = AND. Filter the lineage index by `type:`,
                            `workflow:`, `task:`, `label:`, and/or free-text tokens.

                            Workspace scope is expressed inside the DSL: `workspace:org/name`
                            or the numeric `workspaceId:` alias. Omit both to search every
                            accessible workspace.

## Query parameters

- `q` string
- `pageToken` string
- `pageSize` integer

## Response `200`

OK

- SearchResult
  - `nextPageToken` string
  - `records` LineageRecordResponse[]
    - `data` object
    - `displayData` DisplayData
      - `processName` string
      - `runName` string
      - `taskHash` string
      - `workflowId` string
      - `workspaceId` integer
    - `lid` string
    - `recordUri` string
    - `type` string

## Other responses

- `400` — Invalid query
- `403` — The caller does not participate in one of the requested workspaces

---

[API](https://skmtc.dev/seqeralabs/apis/seqera-api.md) · [All operations](https://skmtc.dev/seqeralabs/apis/seqera-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/seqeralabs/seqera-api/revisions/97f7655d105a/schema)