Retrieve timeline for a business

import requests
url = "https://api.middesk.com/v1/businesses/business_id/timeline"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "object": "list",
  "data": [
    {
      "object": "event",
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "account_id": "f2a3b4c5-d6e7-8901-5678-9abcdef01234",
      "type": "sos_history.address.created",
      "data": {
        "object": {
          "address_line1": "123 Main St",
          "city": "San Francisco",
          "state": "CA",
          "postal_code": "94105",
          "changed_at": "2024-06-15T00:00:00.000Z"
        }
      },
      "occurred_at": "2024-06-15T00:00:00.000Z",
      "created_at": "2025-01-07T12:00:00.000Z"
    },
    {
      "object": "event",
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "account_id": "f2a3b4c5-d6e7-8901-5678-9abcdef01234",
      "type": "sos_history.person.created",
      "data": {
        "object": {
          "name": "John Smith",
          "titles": [
            "CEO",
            "Director"
          ],
          "changed_at": "2024-01-10T00:00:00.000Z"
        }
      },
      "occurred_at": "2024-01-10T00:00:00.000Z",
      "created_at": "2025-01-07T12:00:00.000Z"
    },
    {
      "object": "event",
      "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "account_id": "f2a3b4c5-d6e7-8901-5678-9abcdef01234",
      "type": "registration.updated",
      "data": {
        "object": {
          "status": "active",
          "entity_type": "LLC"
        },
        "previous_attributes": {
          "status": "pending"
        }
      },
      "occurred_at": "2024-03-20T14:30:00.000Z",
      "created_at": "2025-01-07T12:00:00.000Z"
    }
  ]
}

Returns a paginated list of timeline events for a business. Timeline events include Secretary of State (SOS) history events and SOS monitoring events, providing a chronological record of changes to the business’s registration data.

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 on or after this date (YYYY-MM-DD format)

end_datestringOptional

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

event_typesstringOptional

Comma-separated list of event types to filter by

Response

timeline events list

Authentication

Path parameters

Query parameters

Response

Errors