v3

OpenAPI 3.1.02026-07-3178343213.9 KB
timeline

Retrieve timeline for a business

Returns a paginated list of timeline events for a business, providing a chronological record of changes observed on the business's Secretary of State registrations. Events are ordered by occurred_at, newest first.

For accounts with the timeline feature enabled, a business's timeline is constructed once from historical SOS filings when the business's first Verify or Identity order is placed. From then on, new events are appended as Middesk observes registration changes for businesses with an active registration monitor.

get/v1/businesses/{business_id}/timeline

Path parameters

business_idstring required

Business ID

Query parameters

pageinteger

Page number (default: 1)

per_pageinteger

Number of events per page (default: 100, max: 100)

start_datestring

Filter events occurring on or after this date (YYYY-MM-DD format)

end_datestring

Filter events occurring on or before this date (YYYY-MM-DD format)

event_typesstring

Comma-separated list of event types to filter by. Valid values: registration.created, registration.updated, address.created, address.deleted, person.created, person.deleted, name.created, name.deleted

Headers

Authorizationstring required

Bearer authentication

Response

timeline events list

objectstring required
has_moreboolean required
total_countinteger