Skip to content

Latest commit

 

History

History
1161 lines (1133 loc) · 45.4 KB

File metadata and controls

1161 lines (1133 loc) · 45.4 KB

Timeline

The timeline shows recent activity across your Basecamp account or within a specific project. It provides a chronological feed of events like messages posted, to-dos completed, files uploaded, and more.

Endpoints:

Get timeline

  • GET /reports/progress.json will return a paginated list of timeline events across all projects the authenticated user can access.
Example JSON Response
[
  {
    "id": 1071915746,
    "created_at": "2026-02-26T16:42:03.657Z",
    "kind": "project_access_changed",
    "creator": {
      "id": 1049715913,
      "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
      "name": "Victor Cooper",
      "email_address": "victor@honchodesign.com",
      "personable_type": "User",
      "title": "Chief Strategist",
      "bio": "Don’t let your dreams be dreams",
      "location": "Chicago, IL",
      "created_at": "2026-02-12T06:08:49.342Z",
      "updated_at": "2026-02-12T06:08:50.871Z",
      "admin": true,
      "owner": true,
      "client": false,
      "employee": true,
      "time_zone": "America/Chicago",
      "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
      "company": {
        "id": 1033447817,
        "name": "Honcho Design"
      },
      "can_ping": true,
      "can_manage_projects": true,
      "can_manage_people": true,
      "can_access_timesheet": true,
      "can_access_hill_charts": true
    },
    "action": "Victor C. changed who can access this project",
    "target": null,
    "title": "Victor C. changed who can access this project",
    "summary_excerpt": "Steve Marsh was granted access.",
    "avatars_sample": [],
    "bucket": {
      "id": 2085958504,
      "name": "The Leto Laptop",
      "url": "https://3.basecampapi.com/195539477/projects/2085958504.json",
      "app_url": "https://3.basecamp.com/195539477/projects/2085958504"
    }
  },
  {
    "id": 1071915744,
    "created_at": "2026-02-26T16:42:02.762Z",
    "kind": "project_access_changed",
    "creator": {
      "id": 1049715913,
      "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
      "name": "Victor Cooper",
      "email_address": "victor@honchodesign.com",
      "personable_type": "User",
      "title": "Chief Strategist",
      "bio": "Don’t let your dreams be dreams",
      "location": "Chicago, IL",
      "created_at": "2026-02-12T06:08:49.342Z",
      "updated_at": "2026-02-12T06:08:50.871Z",
      "admin": true,
      "owner": true,
      "client": false,
      "employee": true,
      "time_zone": "America/Chicago",
      "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
      "company": {
        "id": 1033447817,
        "name": "Honcho Design"
      },
      "can_ping": true,
      "can_manage_projects": true,
      "can_manage_people": true,
      "can_access_timesheet": true,
      "can_access_hill_charts": true
    },
    "action": "Victor C. changed who can access this project",
    "target": null,
    "title": "Victor C. changed who can access this project",
    "summary_excerpt": "Amy Rivera was granted access.",
    "avatars_sample": [],
    "bucket": {
      "id": 2085958504,
      "name": "The Leto Laptop",
      "url": "https://3.basecampapi.com/195539477/projects/2085958504.json",
      "app_url": "https://3.basecamp.com/195539477/projects/2085958504"
    }
  },
  {
    "id": 1071915727,
    "created_at": "2026-02-26T16:41:57.829Z",
    "kind": "todo_created",
    "parent_recording_id": 1069479982,
    "url": "https://3.basecampapi.com/195539477/buckets/2085958511/todos/1069479985.json",
    "app_url": "https://3.basecamp.com/195539477/buckets/2085958511/todos/1069479985",
    "creator": {
      "id": 1049715913,
      "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
      "name": "Victor Cooper",
      "email_address": "victor@honchodesign.com",
      "personable_type": "User",
      "title": "Chief Strategist",
      "bio": "Don’t let your dreams be dreams",
      "location": "Chicago, IL",
      "created_at": "2026-02-12T06:08:49.342Z",
      "updated_at": "2026-02-12T06:08:50.871Z",
      "admin": true,
      "owner": true,
      "client": false,
      "employee": true,
      "time_zone": "America/Chicago",
      "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
      "company": {
        "id": 1033447817,
        "name": "Honcho Design"
      },
      "can_ping": true,
      "can_manage_projects": true,
      "can_manage_people": true,
      "can_access_timesheet": true,
      "can_access_hill_charts": true
    },
    "action": "Victor C. added a to-do",
    "target": "First things first",
    "title": "On “First things first”, Victor C. added",
    "summary_excerpt": "Install ShipShape",
    "avatars_sample": [],
    "bucket": {
      "id": 2085958511,
      "name": "New project from template",
      "url": "https://3.basecampapi.com/195539477/projects/2085958511.json",
      "app_url": "https://3.basecamp.com/195539477/projects/2085958511"
    },
    "attachments": []
  },
  {
    "id": 1071915726,
    "created_at": "2026-02-26T16:41:57.779Z",
    "kind": "todo_created",
    "parent_recording_id": 1069479982,
    "url": "https://3.basecampapi.com/195539477/buckets/2085958511/todos/1069479984.json",
    "app_url": "https://3.basecamp.com/195539477/buckets/2085958511/todos/1069479984",
    "creator": {
      "id": 1049715913,
      "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
      "name": "Victor Cooper",
      "email_address": "victor@honchodesign.com",
      "personable_type": "User",
      "title": "Chief Strategist",
      "bio": "Don’t let your dreams be dreams",
      "location": "Chicago, IL",
      "created_at": "2026-02-12T06:08:49.342Z",
      "updated_at": "2026-02-12T06:08:50.871Z",
      "admin": true,
      "owner": true,
      "client": false,
      "employee": true,
      "time_zone": "America/Chicago",
      "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
      "company": {
        "id": 1033447817,
        "name": "Honcho Design"
      },
      "can_ping": true,
      "can_manage_projects": true,
      "can_manage_people": true,
      "can_access_timesheet": true,
      "can_access_hill_charts": true
    },
    "action": "Victor C. added a to-do",
    "target": "First things first",
    "title": "On “First things first”, Victor C. added",
    "summary_excerpt": "Talk to Jerry about holidays",
    "avatars_sample": [],
    "bucket": {
      "id": 2085958511,
      "name": "New project from template",
      "url": "https://3.basecampapi.com/195539477/projects/2085958511.json",
      "app_url": "https://3.basecamp.com/195539477/projects/2085958511"
    },
    "attachments": []
  },
  {
    "id": 1071915725,
    "created_at": "2026-02-26T16:41:57.690Z",
    "kind": "todo_created",
    "parent_recording_id": 1069479982,
    "url": "https://3.basecampapi.com/195539477/buckets/2085958511/todos/1069479983.json",
    "app_url": "https://3.basecamp.com/195539477/buckets/2085958511/todos/1069479983",
    "creator": {
      "id": 1049715913,
      "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
      "name": "Victor Cooper",
      "email_address": "victor@honchodesign.com",
      "personable_type": "User",
      "title": "Chief Strategist",
      "bio": "Don’t let your dreams be dreams",
      "location": "Chicago, IL",
      "created_at": "2026-02-12T06:08:49.342Z",
      "updated_at": "2026-02-12T06:08:50.871Z",
      "admin": true,
      "owner": true,
      "client": false,
      "employee": true,
      "time_zone": "America/Chicago",
      "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
      "company": {
        "id": 1033447817,
        "name": "Honcho Design"
      },
      "can_ping": true,
      "can_manage_projects": true,
      "can_manage_people": true,
      "can_access_timesheet": true,
      "can_access_hill_charts": true
    },
    "action": "Victor C. added a to-do",
    "target": "First things first",
    "title": "On “First things first”, Victor C. added",
    "summary_excerpt": "Talk to Cheryl about benefits",
    "avatars_sample": [],
    "bucket": {
      "id": 2085958511,
      "name": "New project from template",
      "url": "https://3.basecampapi.com/195539477/projects/2085958511.json",
      "app_url": "https://3.basecamp.com/195539477/projects/2085958511"
    },
    "attachments": []
  }
]
Copy as cURL
curl -s -H "Authorization: Bearer $ACCESS_TOKEN" https://3.basecampapi.com/$ACCOUNT_ID/reports/progress.json

Get project timeline

  • GET /projects/1/timeline.json will return a paginated list of timeline events in the project with an ID of 1.
Example JSON Response
[
  {
    "id": 1071915746,
    "created_at": "2026-02-26T16:42:03.657Z",
    "kind": "project_access_changed",
    "creator": {
      "id": 1049715913,
      "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
      "name": "Victor Cooper",
      "email_address": "victor@honchodesign.com",
      "personable_type": "User",
      "title": "Chief Strategist",
      "bio": "Don’t let your dreams be dreams",
      "location": "Chicago, IL",
      "created_at": "2026-02-12T06:08:49.342Z",
      "updated_at": "2026-02-12T06:08:50.871Z",
      "admin": true,
      "owner": true,
      "client": false,
      "employee": true,
      "time_zone": "America/Chicago",
      "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
      "company": {
        "id": 1033447817,
        "name": "Honcho Design"
      },
      "can_ping": true,
      "can_manage_projects": true,
      "can_manage_people": true,
      "can_access_timesheet": true,
      "can_access_hill_charts": true
    },
    "action": "Victor C. changed who can access this project",
    "target": null,
    "title": "Victor C. changed who can access this project",
    "summary_excerpt": "Steve Marsh was granted access.",
    "avatars_sample": [],
    "bucket": {
      "id": 2085958504,
      "name": "The Leto Laptop",
      "url": "https://3.basecampapi.com/195539477/projects/2085958504.json",
      "app_url": "https://3.basecamp.com/195539477/projects/2085958504"
    }
  },
  {
    "id": 1071915744,
    "created_at": "2026-02-26T16:42:02.762Z",
    "kind": "project_access_changed",
    "creator": {
      "id": 1049715913,
      "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
      "name": "Victor Cooper",
      "email_address": "victor@honchodesign.com",
      "personable_type": "User",
      "title": "Chief Strategist",
      "bio": "Don’t let your dreams be dreams",
      "location": "Chicago, IL",
      "created_at": "2026-02-12T06:08:49.342Z",
      "updated_at": "2026-02-12T06:08:50.871Z",
      "admin": true,
      "owner": true,
      "client": false,
      "employee": true,
      "time_zone": "America/Chicago",
      "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
      "company": {
        "id": 1033447817,
        "name": "Honcho Design"
      },
      "can_ping": true,
      "can_manage_projects": true,
      "can_manage_people": true,
      "can_access_timesheet": true,
      "can_access_hill_charts": true
    },
    "action": "Victor C. changed who can access this project",
    "target": null,
    "title": "Victor C. changed who can access this project",
    "summary_excerpt": "Amy Rivera was granted access.",
    "avatars_sample": [],
    "bucket": {
      "id": 2085958504,
      "name": "The Leto Laptop",
      "url": "https://3.basecampapi.com/195539477/projects/2085958504.json",
      "app_url": "https://3.basecamp.com/195539477/projects/2085958504"
    }
  }
]
Copy as cURL
curl -s -H "Authorization: Bearer $ACCESS_TOKEN" https://3.basecampapi.com/$ACCOUNT_ID/projects/1/timeline.json

Get person's timeline

  • GET /reports/users/progress/1.json will return a JSON object containing the person plus a paginated list (events) of timeline events created by the person with an ID of 1.
Example JSON Response
{
  "person": {
    "id": 1049715913,
    "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
    "name": "Victor Cooper",
    "email_address": "victor@honchodesign.com",
    "personable_type": "User",
    "title": "Chief Strategist",
    "bio": "Don’t let your dreams be dreams",
    "location": "Chicago, IL",
    "created_at": "2026-02-12T06:08:49.342Z",
    "updated_at": "2026-02-12T06:08:50.871Z",
    "admin": true,
    "owner": true,
    "client": false,
    "employee": true,
    "time_zone": "America/Chicago",
    "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
    "company": {
      "id": 1033447817,
      "name": "Honcho Design"
    },
    "can_ping": true,
    "can_manage_projects": true,
    "can_manage_people": true,
    "can_access_timesheet": true,
    "can_access_hill_charts": true
  },
  "events": [
    {
      "id": 1071915746,
      "created_at": "2026-02-26T16:42:03.657Z",
      "kind": "project_access_changed",
      "creator": {
        "id": 1049715913,
        "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
        "name": "Victor Cooper",
        "email_address": "victor@honchodesign.com",
        "personable_type": "User",
        "title": "Chief Strategist",
        "bio": "Don’t let your dreams be dreams",
        "location": "Chicago, IL",
        "created_at": "2026-02-12T06:08:49.342Z",
        "updated_at": "2026-02-12T06:08:50.871Z",
        "admin": true,
        "owner": true,
        "client": false,
        "employee": true,
        "time_zone": "America/Chicago",
        "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
        "company": {
          "id": 1033447817,
          "name": "Honcho Design"
        },
        "can_ping": true,
        "can_manage_projects": true,
        "can_manage_people": true,
        "can_access_timesheet": true,
        "can_access_hill_charts": true
      },
      "action": "Victor C. changed who can access this project",
      "target": null,
      "title": "Victor C. changed who can access this project",
      "summary_excerpt": "Steve Marsh was granted access.",
      "avatars_sample": [],
      "bucket": {
        "id": 2085958504,
        "name": "The Leto Laptop",
        "url": "https://3.basecampapi.com/195539477/projects/2085958504.json",
        "app_url": "https://3.basecamp.com/195539477/projects/2085958504"
      }
    },
    {
      "id": 1071915744,
      "created_at": "2026-02-26T16:42:02.762Z",
      "kind": "project_access_changed",
      "creator": {
        "id": 1049715913,
        "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
        "name": "Victor Cooper",
        "email_address": "victor@honchodesign.com",
        "personable_type": "User",
        "title": "Chief Strategist",
        "bio": "Don’t let your dreams be dreams",
        "location": "Chicago, IL",
        "created_at": "2026-02-12T06:08:49.342Z",
        "updated_at": "2026-02-12T06:08:50.871Z",
        "admin": true,
        "owner": true,
        "client": false,
        "employee": true,
        "time_zone": "America/Chicago",
        "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
        "company": {
          "id": 1033447817,
          "name": "Honcho Design"
        },
        "can_ping": true,
        "can_manage_projects": true,
        "can_manage_people": true,
        "can_access_timesheet": true,
        "can_access_hill_charts": true
      },
      "action": "Victor C. changed who can access this project",
      "target": null,
      "title": "Victor C. changed who can access this project",
      "summary_excerpt": "Amy Rivera was granted access.",
      "avatars_sample": [],
      "bucket": {
        "id": 2085958504,
        "name": "The Leto Laptop",
        "url": "https://3.basecampapi.com/195539477/projects/2085958504.json",
        "app_url": "https://3.basecamp.com/195539477/projects/2085958504"
      }
    },
    {
      "id": 1071915727,
      "created_at": "2026-02-26T16:41:57.829Z",
      "kind": "todo_created",
      "parent_recording_id": 1069479982,
      "url": "https://3.basecampapi.com/195539477/buckets/2085958511/todos/1069479985.json",
      "app_url": "https://3.basecamp.com/195539477/buckets/2085958511/todos/1069479985",
      "creator": {
        "id": 1049715913,
        "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
        "name": "Victor Cooper",
        "email_address": "victor@honchodesign.com",
        "personable_type": "User",
        "title": "Chief Strategist",
        "bio": "Don’t let your dreams be dreams",
        "location": "Chicago, IL",
        "created_at": "2026-02-12T06:08:49.342Z",
        "updated_at": "2026-02-12T06:08:50.871Z",
        "admin": true,
        "owner": true,
        "client": false,
        "employee": true,
        "time_zone": "America/Chicago",
        "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
        "company": {
          "id": 1033447817,
          "name": "Honcho Design"
        },
        "can_ping": true,
        "can_manage_projects": true,
        "can_manage_people": true,
        "can_access_timesheet": true,
        "can_access_hill_charts": true
      },
      "action": "Victor C. added a to-do",
      "target": "First things first",
      "title": "On “First things first”, Victor C. added",
      "summary_excerpt": "Install ShipShape",
      "avatars_sample": [],
      "bucket": {
        "id": 2085958511,
        "name": "New project from template",
        "url": "https://3.basecampapi.com/195539477/projects/2085958511.json",
        "app_url": "https://3.basecamp.com/195539477/projects/2085958511"
      },
      "attachments": []
    },
    {
      "id": 1071915726,
      "created_at": "2026-02-26T16:41:57.779Z",
      "kind": "todo_created",
      "parent_recording_id": 1069479982,
      "url": "https://3.basecampapi.com/195539477/buckets/2085958511/todos/1069479984.json",
      "app_url": "https://3.basecamp.com/195539477/buckets/2085958511/todos/1069479984",
      "creator": {
        "id": 1049715913,
        "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
        "name": "Victor Cooper",
        "email_address": "victor@honchodesign.com",
        "personable_type": "User",
        "title": "Chief Strategist",
        "bio": "Don’t let your dreams be dreams",
        "location": "Chicago, IL",
        "created_at": "2026-02-12T06:08:49.342Z",
        "updated_at": "2026-02-12T06:08:50.871Z",
        "admin": true,
        "owner": true,
        "client": false,
        "employee": true,
        "time_zone": "America/Chicago",
        "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
        "company": {
          "id": 1033447817,
          "name": "Honcho Design"
        },
        "can_ping": true,
        "can_manage_projects": true,
        "can_manage_people": true,
        "can_access_timesheet": true,
        "can_access_hill_charts": true
      },
      "action": "Victor C. added a to-do",
      "target": "First things first",
      "title": "On “First things first”, Victor C. added",
      "summary_excerpt": "Talk to Jerry about holidays",
      "avatars_sample": [],
      "bucket": {
        "id": 2085958511,
        "name": "New project from template",
        "url": "https://3.basecampapi.com/195539477/projects/2085958511.json",
        "app_url": "https://3.basecamp.com/195539477/projects/2085958511"
      },
      "attachments": []
    },
    {
      "id": 1071915725,
      "created_at": "2026-02-26T16:41:57.690Z",
      "kind": "todo_created",
      "parent_recording_id": 1069479982,
      "url": "https://3.basecampapi.com/195539477/buckets/2085958511/todos/1069479983.json",
      "app_url": "https://3.basecamp.com/195539477/buckets/2085958511/todos/1069479983",
      "creator": {
        "id": 1049715913,
        "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
        "name": "Victor Cooper",
        "email_address": "victor@honchodesign.com",
        "personable_type": "User",
        "title": "Chief Strategist",
        "bio": "Don’t let your dreams be dreams",
        "location": "Chicago, IL",
        "created_at": "2026-02-12T06:08:49.342Z",
        "updated_at": "2026-02-12T06:08:50.871Z",
        "admin": true,
        "owner": true,
        "client": false,
        "employee": true,
        "time_zone": "America/Chicago",
        "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
        "company": {
          "id": 1033447817,
          "name": "Honcho Design"
        },
        "can_ping": true,
        "can_manage_projects": true,
        "can_manage_people": true,
        "can_access_timesheet": true,
        "can_access_hill_charts": true
      },
      "action": "Victor C. added a to-do",
      "target": "First things first",
      "title": "On “First things first”, Victor C. added",
      "summary_excerpt": "Talk to Cheryl about benefits",
      "avatars_sample": [],
      "bucket": {
        "id": 2085958511,
        "name": "New project from template",
        "url": "https://3.basecampapi.com/195539477/projects/2085958511.json",
        "app_url": "https://3.basecamp.com/195539477/projects/2085958511"
      },
      "attachments": []
    },
    {
      "id": 1071915719,
      "created_at": "2026-02-26T16:41:57.309Z",
      "kind": "dock_created",
      "url": "https://3.basecampapi.com/195539477/buckets/2085958511/dock.json",
      "app_url": "https://3.basecamp.com/195539477/projects/2085958511",
      "creator": {
        "id": 1049715913,
        "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
        "name": "Victor Cooper",
        "email_address": "victor@honchodesign.com",
        "personable_type": "User",
        "title": "Chief Strategist",
        "bio": "Don’t let your dreams be dreams",
        "location": "Chicago, IL",
        "created_at": "2026-02-12T06:08:49.342Z",
        "updated_at": "2026-02-12T06:08:50.871Z",
        "admin": true,
        "owner": true,
        "client": false,
        "employee": true,
        "time_zone": "America/Chicago",
        "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
        "company": {
          "id": 1033447817,
          "name": "Honcho Design"
        },
        "can_ping": true,
        "can_manage_projects": true,
        "can_manage_people": true,
        "can_access_timesheet": true,
        "can_access_hill_charts": true
      },
      "action": "Victor C. started a new project called New project from template",
      "target": "New project from template",
      "title": "Victor C. started a new project called “New project from template”",
      "summary_excerpt": null,
      "avatars_sample": [],
      "bucket": {
        "id": 2085958511,
        "name": "New project from template",
        "url": "https://3.basecampapi.com/195539477/projects/2085958511.json",
        "app_url": "https://3.basecamp.com/195539477/projects/2085958511"
      },
      "attachments": []
    },
    {
      "id": 1071915692,
      "created_at": "2026-02-12T06:13:55.569Z",
      "kind": "project_access_changed",
      "creator": {
        "id": 1049715913,
        "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
        "name": "Victor Cooper",
        "email_address": "victor@honchodesign.com",
        "personable_type": "User",
        "title": "Chief Strategist",
        "bio": "Don’t let your dreams be dreams",
        "location": "Chicago, IL",
        "created_at": "2026-02-12T06:08:49.342Z",
        "updated_at": "2026-02-12T06:08:50.871Z",
        "admin": true,
        "owner": true,
        "client": false,
        "employee": true,
        "time_zone": "America/Chicago",
        "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
        "company": {
          "id": 1033447817,
          "name": "Honcho Design"
        },
        "can_ping": true,
        "can_manage_projects": true,
        "can_manage_people": true,
        "can_access_timesheet": true,
        "can_access_hill_charts": true
      },
      "action": "Victor C. changed who can access this project",
      "target": null,
      "title": "Victor C. changed who can access this project",
      "summary_excerpt": "Steve Marsh was granted access.",
      "avatars_sample": [],
      "bucket": {
        "id": 2085958504,
        "name": "The Leto Laptop",
        "url": "https://3.basecampapi.com/195539477/projects/2085958504.json",
        "app_url": "https://3.basecamp.com/195539477/projects/2085958504"
      }
    },
    {
      "id": 1071915690,
      "created_at": "2026-02-12T06:13:54.966Z",
      "kind": "project_access_changed",
      "creator": {
        "id": 1049715913,
        "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
        "name": "Victor Cooper",
        "email_address": "victor@honchodesign.com",
        "personable_type": "User",
        "title": "Chief Strategist",
        "bio": "Don’t let your dreams be dreams",
        "location": "Chicago, IL",
        "created_at": "2026-02-12T06:08:49.342Z",
        "updated_at": "2026-02-12T06:08:50.871Z",
        "admin": true,
        "owner": true,
        "client": false,
        "employee": true,
        "time_zone": "America/Chicago",
        "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
        "company": {
          "id": 1033447817,
          "name": "Honcho Design"
        },
        "can_ping": true,
        "can_manage_projects": true,
        "can_manage_people": true,
        "can_access_timesheet": true,
        "can_access_hill_charts": true
      },
      "action": "Victor C. changed who can access this project",
      "target": null,
      "title": "Victor C. changed who can access this project",
      "summary_excerpt": "Amy Rivera was granted access.",
      "avatars_sample": [],
      "bucket": {
        "id": 2085958504,
        "name": "The Leto Laptop",
        "url": "https://3.basecampapi.com/195539477/projects/2085958504.json",
        "app_url": "https://3.basecamp.com/195539477/projects/2085958504"
      }
    },
    {
      "id": 1071915673,
      "created_at": "2026-02-12T06:13:49.017Z",
      "kind": "todo_created",
      "parent_recording_id": 1069479950,
      "url": "https://3.basecampapi.com/195539477/buckets/2085958510/todos/1069479953.json",
      "app_url": "https://3.basecamp.com/195539477/buckets/2085958510/todos/1069479953",
      "creator": {
        "id": 1049715913,
        "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
        "name": "Victor Cooper",
        "email_address": "victor@honchodesign.com",
        "personable_type": "User",
        "title": "Chief Strategist",
        "bio": "Don’t let your dreams be dreams",
        "location": "Chicago, IL",
        "created_at": "2026-02-12T06:08:49.342Z",
        "updated_at": "2026-02-12T06:08:50.871Z",
        "admin": true,
        "owner": true,
        "client": false,
        "employee": true,
        "time_zone": "America/Chicago",
        "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
        "company": {
          "id": 1033447817,
          "name": "Honcho Design"
        },
        "can_ping": true,
        "can_manage_projects": true,
        "can_manage_people": true,
        "can_access_timesheet": true,
        "can_access_hill_charts": true
      },
      "action": "Victor C. added a to-do",
      "target": "First things first",
      "title": "On “First things first”, Victor C. added",
      "summary_excerpt": "Install ShipShape",
      "avatars_sample": [],
      "bucket": {
        "id": 2085958510,
        "name": "New project from template",
        "url": "https://3.basecampapi.com/195539477/projects/2085958510.json",
        "app_url": "https://3.basecamp.com/195539477/projects/2085958510"
      },
      "attachments": []
    },
    {
      "id": 1071915672,
      "created_at": "2026-02-12T06:13:48.958Z",
      "kind": "todo_created",
      "parent_recording_id": 1069479950,
      "url": "https://3.basecampapi.com/195539477/buckets/2085958510/todos/1069479952.json",
      "app_url": "https://3.basecamp.com/195539477/buckets/2085958510/todos/1069479952",
      "creator": {
        "id": 1049715913,
        "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
        "name": "Victor Cooper",
        "email_address": "victor@honchodesign.com",
        "personable_type": "User",
        "title": "Chief Strategist",
        "bio": "Don’t let your dreams be dreams",
        "location": "Chicago, IL",
        "created_at": "2026-02-12T06:08:49.342Z",
        "updated_at": "2026-02-12T06:08:50.871Z",
        "admin": true,
        "owner": true,
        "client": false,
        "employee": true,
        "time_zone": "America/Chicago",
        "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
        "company": {
          "id": 1033447817,
          "name": "Honcho Design"
        },
        "can_ping": true,
        "can_manage_projects": true,
        "can_manage_people": true,
        "can_access_timesheet": true,
        "can_access_hill_charts": true
      },
      "action": "Victor C. added a to-do",
      "target": "First things first",
      "title": "On “First things first”, Victor C. added",
      "summary_excerpt": "Talk to Jerry about holidays",
      "avatars_sample": [],
      "bucket": {
        "id": 2085958510,
        "name": "New project from template",
        "url": "https://3.basecampapi.com/195539477/projects/2085958510.json",
        "app_url": "https://3.basecamp.com/195539477/projects/2085958510"
      },
      "attachments": []
    },
    {
      "id": 1071915671,
      "created_at": "2026-02-12T06:13:48.910Z",
      "kind": "todo_created",
      "parent_recording_id": 1069479950,
      "url": "https://3.basecampapi.com/195539477/buckets/2085958510/todos/1069479951.json",
      "app_url": "https://3.basecamp.com/195539477/buckets/2085958510/todos/1069479951",
      "creator": {
        "id": 1049715913,
        "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
        "name": "Victor Cooper",
        "email_address": "victor@honchodesign.com",
        "personable_type": "User",
        "title": "Chief Strategist",
        "bio": "Don’t let your dreams be dreams",
        "location": "Chicago, IL",
        "created_at": "2026-02-12T06:08:49.342Z",
        "updated_at": "2026-02-12T06:08:50.871Z",
        "admin": true,
        "owner": true,
        "client": false,
        "employee": true,
        "time_zone": "America/Chicago",
        "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
        "company": {
          "id": 1033447817,
          "name": "Honcho Design"
        },
        "can_ping": true,
        "can_manage_projects": true,
        "can_manage_people": true,
        "can_access_timesheet": true,
        "can_access_hill_charts": true
      },
      "action": "Victor C. added a to-do",
      "target": "First things first",
      "title": "On “First things first”, Victor C. added",
      "summary_excerpt": "Talk to Cheryl about benefits",
      "avatars_sample": [],
      "bucket": {
        "id": 2085958510,
        "name": "New project from template",
        "url": "https://3.basecampapi.com/195539477/projects/2085958510.json",
        "app_url": "https://3.basecamp.com/195539477/projects/2085958510"
      },
      "attachments": []
    },
    {
      "id": 1071915665,
      "created_at": "2026-02-12T06:13:48.702Z",
      "kind": "dock_created",
      "url": "https://3.basecampapi.com/195539477/buckets/2085958510/dock.json",
      "app_url": "https://3.basecamp.com/195539477/projects/2085958510",
      "creator": {
        "id": 1049715913,
        "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
        "name": "Victor Cooper",
        "email_address": "victor@honchodesign.com",
        "personable_type": "User",
        "title": "Chief Strategist",
        "bio": "Don’t let your dreams be dreams",
        "location": "Chicago, IL",
        "created_at": "2026-02-12T06:08:49.342Z",
        "updated_at": "2026-02-12T06:08:50.871Z",
        "admin": true,
        "owner": true,
        "client": false,
        "employee": true,
        "time_zone": "America/Chicago",
        "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
        "company": {
          "id": 1033447817,
          "name": "Honcho Design"
        },
        "can_ping": true,
        "can_manage_projects": true,
        "can_manage_people": true,
        "can_access_timesheet": true,
        "can_access_hill_charts": true
      },
      "action": "Victor C. started a new project called New project from template",
      "target": "New project from template",
      "title": "Victor C. started a new project called “New project from template”",
      "summary_excerpt": null,
      "avatars_sample": [],
      "bucket": {
        "id": 2085958510,
        "name": "New project from template",
        "url": "https://3.basecampapi.com/195539477/projects/2085958510.json",
        "app_url": "https://3.basecamp.com/195539477/projects/2085958510"
      },
      "attachments": []
    },
    {
      "id": 1071915646,
      "created_at": "2026-02-12T06:13:12.912Z",
      "kind": "todo_created",
      "parent_recording_id": 1069479926,
      "url": "https://3.basecampapi.com/195539477/buckets/2085958509/todos/1069479929.json",
      "app_url": "https://3.basecamp.com/195539477/buckets/2085958509/todos/1069479929",
      "creator": {
        "id": 1049715913,
        "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
        "name": "Victor Cooper",
        "email_address": "victor@honchodesign.com",
        "personable_type": "User",
        "title": "Chief Strategist",
        "bio": "Don’t let your dreams be dreams",
        "location": "Chicago, IL",
        "created_at": "2026-02-12T06:08:49.342Z",
        "updated_at": "2026-02-12T06:08:50.871Z",
        "admin": true,
        "owner": true,
        "client": false,
        "employee": true,
        "time_zone": "America/Chicago",
        "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
        "company": {
          "id": 1033447817,
          "name": "Honcho Design"
        },
        "can_ping": true,
        "can_manage_projects": true,
        "can_manage_people": true,
        "can_access_timesheet": true,
        "can_access_hill_charts": true
      },
      "action": "Victor C. added a to-do",
      "target": "First things first",
      "title": "On “First things first”, Victor C. added",
      "summary_excerpt": "Install ShipShape",
      "avatars_sample": [],
      "bucket": {
        "id": 2085958509,
        "name": "New project from template",
        "url": "https://3.basecampapi.com/195539477/projects/2085958509.json",
        "app_url": "https://3.basecamp.com/195539477/projects/2085958509"
      },
      "attachments": []
    },
    {
      "id": 1071915645,
      "created_at": "2026-02-12T06:13:12.885Z",
      "kind": "todo_created",
      "parent_recording_id": 1069479926,
      "url": "https://3.basecampapi.com/195539477/buckets/2085958509/todos/1069479928.json",
      "app_url": "https://3.basecamp.com/195539477/buckets/2085958509/todos/1069479928",
      "creator": {
        "id": 1049715913,
        "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
        "name": "Victor Cooper",
        "email_address": "victor@honchodesign.com",
        "personable_type": "User",
        "title": "Chief Strategist",
        "bio": "Don’t let your dreams be dreams",
        "location": "Chicago, IL",
        "created_at": "2026-02-12T06:08:49.342Z",
        "updated_at": "2026-02-12T06:08:50.871Z",
        "admin": true,
        "owner": true,
        "client": false,
        "employee": true,
        "time_zone": "America/Chicago",
        "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
        "company": {
          "id": 1033447817,
          "name": "Honcho Design"
        },
        "can_ping": true,
        "can_manage_projects": true,
        "can_manage_people": true,
        "can_access_timesheet": true,
        "can_access_hill_charts": true
      },
      "action": "Victor C. added a to-do",
      "target": "First things first",
      "title": "On “First things first”, Victor C. added",
      "summary_excerpt": "Talk to Jerry about holidays",
      "avatars_sample": [],
      "bucket": {
        "id": 2085958509,
        "name": "New project from template",
        "url": "https://3.basecampapi.com/195539477/projects/2085958509.json",
        "app_url": "https://3.basecamp.com/195539477/projects/2085958509"
      },
      "attachments": []
    },
    {
      "id": 1071915644,
      "created_at": "2026-02-12T06:13:12.854Z",
      "kind": "todo_created",
      "parent_recording_id": 1069479926,
      "url": "https://3.basecampapi.com/195539477/buckets/2085958509/todos/1069479927.json",
      "app_url": "https://3.basecamp.com/195539477/buckets/2085958509/todos/1069479927",
      "creator": {
        "id": 1049715913,
        "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
        "name": "Victor Cooper",
        "email_address": "victor@honchodesign.com",
        "personable_type": "User",
        "title": "Chief Strategist",
        "bio": "Don’t let your dreams be dreams",
        "location": "Chicago, IL",
        "created_at": "2026-02-12T06:08:49.342Z",
        "updated_at": "2026-02-12T06:08:50.871Z",
        "admin": true,
        "owner": true,
        "client": false,
        "employee": true,
        "time_zone": "America/Chicago",
        "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
        "company": {
          "id": 1033447817,
          "name": "Honcho Design"
        },
        "can_ping": true,
        "can_manage_projects": true,
        "can_manage_people": true,
        "can_access_timesheet": true,
        "can_access_hill_charts": true
      },
      "action": "Victor C. added a to-do",
      "target": "First things first",
      "title": "On “First things first”, Victor C. added",
      "summary_excerpt": "Talk to Cheryl about benefits",
      "avatars_sample": [],
      "bucket": {
        "id": 2085958509,
        "name": "New project from template",
        "url": "https://3.basecampapi.com/195539477/projects/2085958509.json",
        "app_url": "https://3.basecamp.com/195539477/projects/2085958509"
      },
      "attachments": []
    }
  ]
}
Copy as cURL
curl -s -H "Authorization: Bearer $ACCESS_TOKEN" https://3.basecampapi.com/$ACCOUNT_ID/reports/users/progress/1.json

Event kinds

The kind field indicates what type of activity occurred. Common values include:

Kind Description
message_created A new message was posted
comment_created A comment was added
todo_created A new to-do was added
todo_completed A to-do was checked off
upload_created A file was uploaded
document_created A document was created
schedule_entry_created A calendar event was added
schedule_entry_rescheduled A calendar event was rescheduled
question_created An automatic check-in was started
question_answer_created Someone answered a check-in
chat_transcript_rollup A summary of Campfire chat activity
kanban_card_created A card was added to a Card Table
kanban_card_completed A card was completed
inbox_forward_created An email was forwarded
client_correspondence_created A message was sent to a client

Event fields

Each timeline event includes these fields:

Field Description
id Unique identifier for the event
created_at When the event occurred
kind The type of activity (see Event kinds)
parent_recording_id ID of the parent container (e.g., to-do list for a to-do), if applicable
url API URL to fetch the item
app_url Link to view the item in Basecamp
creator The person who performed the action
action Human-readable description of the action
target The name of the parent container or item affected
title Combined action and target as a complete sentence
summary_excerpt A brief excerpt of the content, if available
avatars_sample Array of avatar URLs (used for chat rollups showing participants)
bucket The project where the event occurred
data Additional event-specific data (e.g., schedule entry times)
attachments Array of attached files, if any

Schedule entry data

Events with kind of schedule_entry_created or schedule_entry_rescheduled include a data object with schedule details:

{
  "data": {
    "all_day": false,
    "starts_at": "2025-10-30T10:00:00.000-05:00",
    "ends_at": "2025-10-30T11:00:00.000-05:00"
  }
}