Skip to main content
GET
List workflow runs in a matter

Authorizations

Authorization
string
header
required

Workspace credential issued from the automation console at /automation. Send it as Authorization: Bearer vq_ws_.... This is NOT a Data API key: a vq_key_ credential is refused here and names the other product in the error.

Path Parameters

matterId
string
required

mat_ identifier of the matter to work inside. Everything in this API hangs off a matter, and the matter in the path is what the authorization boundary is checked against. Take it from GET /v1/matters.

Query Parameters

limit
integer
default:50

How many rows to return, 1 to 200. Defaults to 50.

Required range: 1 <= x <= 200
offset
integer
default:0

How many rows to skip before returning any. Combine with limit to page: offset=0, then offset=50, and so on. Offsets are positional, not stable, so a set that changes while you page can show a row twice or not at all.

Required range: x >= 0

Response

Successful Response

data
WorkflowRun · object[]
required

The rows in this window, in the collection's default order.

pagination
Pagination · object
required

Where this window sits in the full result set.

Last modified on August 23, 2026