For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact SalesGet Support
HomeGuidesAPI reference
HomeGuidesAPI reference
  • Middesk API
        • GETRetrieve timeline for a business
LogoLogo
Contact SalesGet Support
Middesk APIBusiness VerificationTimeline

Retrieve timeline for a business

GET
https://api.middesk.com/v1/businesses/:business_id/timeline
GET
/v1/businesses/:business_id/timeline
$curl https://api.middesk.com/v1/businesses/business_id/timeline \
>     -H "Authorization: Bearer <token>"
1{
2  "object": "list",
3  "data": [
4    {
5      "object": "event",
6      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
7      "account_id": "f2a3b4c5-d6e7-8901-5678-9abcdef01234",
8      "type": "sos_history.address.created",
9      "data": {
10        "object": {
11          "address_line1": "123 Main St",
12          "city": "San Francisco",
13          "state": "CA",
14          "postal_code": "94105",
15          "changed_at": "2024-06-15T00:00:00.000Z"
16        }
17      },
18      "occurred_at": "2024-06-15T00:00:00.000Z",
19      "created_at": "2025-01-07T12:00:00.000Z"
20    },
21    {
22      "object": "event",
23      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
24      "account_id": "f2a3b4c5-d6e7-8901-5678-9abcdef01234",
25      "type": "sos_history.person.created",
26      "data": {
27        "object": {
28          "name": "John Smith",
29          "titles": [
30            "CEO",
31            "Director"
32          ],
33          "changed_at": "2024-01-10T00:00:00.000Z"
34        }
35      },
36      "occurred_at": "2024-01-10T00:00:00.000Z",
37      "created_at": "2025-01-07T12:00:00.000Z"
38    },
39    {
40      "object": "event",
41      "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
42      "account_id": "f2a3b4c5-d6e7-8901-5678-9abcdef01234",
43      "type": "registration.updated",
44      "data": {
45        "object": {
46          "status": "active",
47          "entity_type": "LLC"
48        },
49        "previous_attributes": {
50          "status": "pending"
51        }
52      },
53      "occurred_at": "2024-03-20T14:30:00.000Z",
54      "created_at": "2025-01-07T12:00:00.000Z"
55    }
56  ]
57}

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.

Was this page helpful?
Previous

Action object

Next
Built with

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

Errors

404
Get Business Timeline Request Not Found Error