Skip to main content
GET
List a company's change events

Authorizations

Authorization
string
header
required

Use a personal or organization Pav API key from Pav developer settings. Send it as Authorization: Bearer <api_key>.

Path Parameters

company_id
integer
required

Durable Pav company id.

Example:

412

Query Parameters

change_type
enum<string>[] | null

Filter by change type: insert, update, delete. Repeatable.

Available options:
insert,
update,
delete
Example:

"update"

since
string<date-time> | null

Only changes detected at or after this timestamp (ISO 8601).

Example:

"2026-06-01T00:00:00Z"

include_invalidated
boolean
default:false

Include changes later retracted after a correction.

Example:

false

cursor
string | null

Opaque cursor from a prior response's next_cursor. Preferred over offset; wins when both are sent.

limit
integer
default:50

Maximum rows to return (1-5000).

Required range: 1 <= x <= 5000
Example:

50

offset
integer
default:0

Zero-based row offset. Prefer cursor.

Required range: 0 <= x <= 2000000000
Example:

0

Response

Successful Response

data
ChangeEvent · object[]
required

Page of pipeline change events.

pagination
Pagination · object
required

Pagination metadata for this page.

next_cursor
string | null

Opaque cursor to fetch the next page; pass it back as ?cursor=. Null when this page exhausts the feed. Stable under concurrent inserts (unlike offset).

Example:

"<opaque cursor>"