Retrieve timeline for a business

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "event",
      "id": "e0000001-0000-4000-8000-000000000001",
      "account_id": "f2a3b4c5-d6e7-8901-5678-9abcdef01234",
      "type": "person.created",
      "data": {
        "object": {
          "business_id": "a0b1c2d3-e4f5-6789-0abc-def012345678",
          "name": "ROGER SMITH",
          "object": "person",
          "sources": [
            {
              "id": "d4e5f6a7-b8c9-0123-def0-123456789012",
              "metadata": {
                "file_number": "C1234567",
                "jurisdiction": "DOMESTIC",
                "state": "CA",
                "status": "active"
              },
              "type": "registration"
            }
          ],
          "submitted": false
        }
      },
      "occurred_at": "2026-05-20T08:30:00Z",
      "created_at": "2026-05-20T08:30:00Z"
    },
    {
      "object": "event",
      "id": "e0000002-0000-4000-8000-000000000002",
      "account_id": "f2a3b4c5-d6e7-8901-5678-9abcdef01234",
      "type": "name.deleted",
      "data": {
        "object": {
          "business_id": "a0b1c2d3-e4f5-6789-0abc-def012345678",
          "name": "ACME HOLDINGS LLC",
          "object": "name",
          "sources": [
            {
              "id": "d4e5f6a7-b8c9-0123-def0-123456789012",
              "metadata": {
                "file_number": "C1234567",
                "jurisdiction": "DOMESTIC",
                "state": "CA"
              },
              "type": "registration"
            }
          ],
          "submitted": false
        }
      },
      "occurred_at": "2023-08-10T00:00:00Z",
      "created_at": "2026-01-07T12:00:00Z"
    },
    {
      "object": "event",
      "id": "e0000003-0000-4000-8000-000000000003",
      "account_id": "f2a3b4c5-d6e7-8901-5678-9abcdef01234",
      "type": "person.created",
      "data": {
        "object": {
          "business_id": "a0b1c2d3-e4f5-6789-0abc-def012345678",
          "name": "JANE DOE",
          "object": "person",
          "sources": [
            {
              "id": "d4e5f6a7-b8c9-0123-def0-123456789012",
              "metadata": {
                "file_number": "C1234567",
                "jurisdiction": "DOMESTIC",
                "state": "CA"
              },
              "type": "registration"
            }
          ],
          "submitted": false,
          "titles": [
            {
              "object": "person_title",
              "title": "PRESIDENT"
            }
          ]
        }
      },
      "occurred_at": "2022-04-01T00:00:00Z",
      "created_at": "2026-01-07T12:00:00Z"
    },
    {
      "object": "event",
      "id": "e0000004-0000-4000-8000-000000000004",
      "account_id": "f2a3b4c5-d6e7-8901-5678-9abcdef01234",
      "type": "registration.updated",
      "data": {
        "object": {
          "business_id": "a0b1c2d3-e4f5-6789-0abc-def012345678",
          "file_number": "C1234567",
          "id": "d4e5f6a7-b8c9-0123-def0-123456789012",
          "jurisdiction": "DOMESTIC",
          "object": "registration",
          "registration_date": "2019-01-15",
          "state": "CA",
          "status": "inactive"
        },
        "previous_attributes": {
          "status": "active"
        }
      },
      "occurred_at": "2021-03-02T00:00:00Z",
      "created_at": "2026-01-07T12:00:00Z"
    },
    {
      "object": "event",
      "id": "e0000005-0000-4000-8000-000000000005",
      "account_id": "f2a3b4c5-d6e7-8901-5678-9abcdef01234",
      "type": "address.created",
      "data": {
        "object": {
          "business_id": "a0b1c2d3-e4f5-6789-0abc-def012345678",
          "cmra": false,
          "created_at": "2020-06-15T00:00:00Z",
          "full_address": "123 MAIN ST, SAN FRANCISCO, CA 94105",
          "is_registered_agent": false,
          "object": "address",
          "rating": {
            "risk_rating": "not_available"
          },
          "sources": [
            {
              "id": "d4e5f6a7-b8c9-0123-def0-123456789012",
              "metadata": {
                "file_number": "C1234567",
                "jurisdiction": "DOMESTIC",
                "state": "CA"
              },
              "type": "registration"
            }
          ],
          "submitted": false,
          "updated_at": "2020-06-15T00:00:00Z"
        }
      },
      "occurred_at": "2020-06-15T00:00:00Z",
      "created_at": "2026-01-07T12:00:00Z"
    },
    {
      "object": "event",
      "id": "e0000006-0000-4000-8000-000000000006",
      "account_id": "f2a3b4c5-d6e7-8901-5678-9abcdef01234",
      "type": "registration.created",
      "data": {
        "object": {
          "business_id": "a0b1c2d3-e4f5-6789-0abc-def012345678",
          "file_number": "C1234567",
          "id": "d4e5f6a7-b8c9-0123-def0-123456789012",
          "jurisdiction": "DOMESTIC",
          "object": "registration",
          "registration_date": "2019-01-15",
          "state": "CA"
        }
      },
      "occurred_at": "2019-01-15T00:00:00Z",
      "created_at": "2026-01-07T12:00:00Z"
    }
  ],
  "total_count": 6
}

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.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

business_idstringRequired

Business ID

Query parameters

pageintegerOptional

Page number (default: 1)

per_pageintegerOptional

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

start_datestringOptional

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

end_datestringOptional

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

event_typesstringOptional

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

Response

timeline events list

objectstring

has_moreboolean

datalist of objectsOptional

total_countintegerOptional

Errors

404

Get Business Timeline Request Not Found Error