Skip to main content
GET
Get a fact set

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.

factSetId
string
required

fct_ identifier of the fact set. Returned on the operation that generated it.

Response

Successful Response

One generated ledger.

id
string
required

fct_ identifier. The same id the operation's resource carries.

Example:

"fct_9f2c8b1e4a7d43c9b6e0f1a2c3d4e5f6"

matterId
string
required

The mat_ matter this set covers.

Example:

"mat_9f2c8b1e4a7d43c9b6e0f1a2c3d4e5f6"

status
enum<string>
required

The generation's status, in the same five values every operation uses.

Available options:
queued,
running,
succeeded,
failed,
cancelled
Example:

"succeeded"

mode
string
required

How this set was generated. standard re-reads the matter, incremental reads only what changed. Sets generated from the web app may report deep, which this API does not accept.

Example:

"standard"

isCurrent
boolean
required

True for the one set in force for this matter. Generating a new set makes the previous one false; nothing is deleted, and its facts stay readable.

Example:

false

isStale
boolean
required

True when the matter's documents have changed since this set was built. Computed per request against the current document set, never stored.

Example:

false

changedDocCount
integer
required

How many documents the matter has gained since this set was generated. Zero with isStale true means documents were re-ingested rather than added.

Example:

1

coverage
FactSetCoverage · object
required

What the generation read.

createdAt
string<date-time>
required

When the generation was requested.

Example:

"2026-08-19T14:32:10Z"

factCount
integer | null

Facts in the set, once it has finished.

Example:

1

conflictCount
integer | null

Facts the reducer flagged as conflicted.

Example:

1

completedAt
string<date-time> | null

When the generation finished. Null until it does.

Example:

"2026-08-19T14:32:10Z"

Last modified on August 23, 2026