---
title: "Get the runs search query reference (beta)"
method: GET
path: "/workflows/runs/query/reference"
tags: ["workflowsRuns"]
---

# Get the runs search query reference (beta)

`GET /workflows/runs/query/reference`

## Request

- Base URL: `https://api.clay.com/public/v0`
- URL: `https://api.clay.com/public/v0/workflows/runs/query/reference`
- Auth: API key in header `clay-api-key`

Returns the Clay workflow-run query reference document (markdown), covering the queryable run fields, node predicates, content search, and the query grammar. Use it to author a workflow-run query.

## Response `200`

200

- RunsQueryReferenceResponse
  - `reference` string, required

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `429`: 429

## Changes

- **2026-09-09** `1ad1dc0d13b2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clay/apis/clay-public-api/changes/workflows/runs/query/reference/get.md)

---

[API](https://skmtc.dev/clay/apis/clay-public-api.md) - [All operations](https://skmtc.dev/clay/apis/clay-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clay/apis/clay-public-api/revisions/583f58ced7f1?raw)