Skip to main content
GET
List chronology events

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

dateFrom
string<date> | null

Only events on or after this date.

dateTo
string<date> | null

Only events on or before this date.

eventTypes
enum<string>[] | null

Only these event types. Omit for all of them.

Available options:
signed,
executed,
filed,
served,
effective,
expired,
terminated,
notice_sent,
notice_received,
payment,
hearing,
meeting,
judgment,
order,
correspondence,
amended,
enacted,
published,
decided,
incident,
referenced,
founded,
incorporated,
appointed,
resigned,
acquired,
launched,
awarded,
approved,
registered,
commenced,
completed,
transferred,
invested,
dissolved,
announced,
renewed,
other
categories
enum<string>[] | null

Only these swim lanes.

Available options:
contract_event,
court_filing,
correspondence,
payment_financial,
deadline_notice,
meeting_hearing,
legislative,
case_law,
historical,
corporate,
regulatory,
employment,
milestone,
other
significance
enum<string>[] | null

Only these significance levels.

Available options:
high,
medium,
low
documentId
string | null

Only events extracted from this doc_ document.

isAiExtracted
boolean | null

True for extracted events only, false for hand-entered ones only.

minConfidence
number | null

Only extracted events at or above this confidence. Note that a manual event has no confidence at all and is excluded by any value here.

Required range: 0 <= x <= 1
searchQuery
string | null

Substring match on title or description.

Maximum string length: 200
Example:

"termination notice"

party
string | null

Only events naming this party exactly.

Maximum string length: 200
Example:

"Acme Corporation"

primaryOnly
boolean
default:false

Collapse duplicate events to one per group. Events that are in no duplicate group are always kept.

limit
integer
default:50

How many events to return.

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

How many to skip first.

Required range: x >= 0
sortBy
enum<string>
default:event_date

Which field to order by.

Available options:
event_date,
created_at,
significance,
title
sortOrder
enum<string>
default:asc

Ascending by default, because a timeline reads forward in time.

Available options:
asc,
desc

Response

Successful Response

data
ChronologyEvent · 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