---
title: "Retrieve timeline for a business"
method: GET
path: "/v1/businesses/{business_id}/timeline"
tags: ["timeline"]
---

# Retrieve timeline for a business

`GET /v1/businesses/{business_id}/timeline`

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](https://docs.middesk.com/reference/monitor).

## Path parameters

- `business_id` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `start_date` string
- `end_date` string
- `event_types` string

## Headers

- `Authorization` string, required

## Response `200`

timeline events list

- TypeTimelineGetBusinessTimelineResponse
  - `data` TypeTimelineEvent[]
    - `object` 'event', required
    - `id` string, uuid, required
    - `account_id` string, uuid, required
    - `type` 'registration.created' | 'registration.updated' | 'address.created' | 'address.deleted' | 'person.created' | 'person.deleted' | 'name.created' | 'name.deleted', required — The kind of change observed. A name change is represented as a `name.deleted` event for the old name paired with a `name.created` event for the new name.
    - `data` TypeTimelineEventData, required
      - `object` object, required — The resource the change was observed on, matching the event `type`: an [Address](https://docs.middesk.com/reference/address), [Person](https://docs.middesk.com/reference/person), [Name](https://docs.middesk.com/reference/names), or [Registration](https://docs.middesk.com/reference/registration) as described in the Business Verification Object Reference. Events constructed from historical Secretary of State filings carry null values for any fields the filing did not supply. In particular, addresses, names, and people on historical events have a null `id` — they describe past observations, not retrievable records — and registrations on historical events carry null values for `name`, `entity_type`, and (on `registration.created`) `status`.
      - `previous_attributes` object — The prior values of the registration fields that changed. Present only on `registration.updated` events. A null value means the field previously had no value.
    - `occurred_at` string, date-time, required — When the change occurred in the real world, falling back to when Middesk recorded the event if the source did not report a timestamp.
    - `created_at` string, date-time, required — When Middesk recorded the event.
  - `object` string, required
  - `has_more` boolean, required
  - `total_count` integer

## Other responses

- `404` — business not found

---

[API](https://skmtc.net/middesk/apis/middesk-api.md) · [All operations](https://skmtc.net/middesk/apis/middesk-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/middesk/middesk-api/revisions/015f33b27f13/schema)