Returns a list of timeline items for the given incident.
URL parameters
The ID of the incident you want to get
Headers
Bearer $TOKEN
The structure of the data attribute of the timeline item depends on the item type. The item_type can have these values:
- generic
- generic_card
- timeline_trucated
- response_item
- payload
- comment
Response body
{
"data": [
{
"id": "2021-02-12 23:59:59 UTC",
"type": "timeline_item",
"attributes": {
"item_type": "timeline_truncated",
"at": "2021-02-12T23:59:59.000Z",
"data": {
"title": "Skipping 123 timeline events"
}
}
},
{
"id": "23",
"type": "timeline_item",
"attributes": {
"item_type": "comment",
"at": "2021-02-12T10:44:46.618Z",
"data": {
"title": null,
"content": {
"text": "Some comment with attachment",
"user": {
"id": 123,
"name": "John Smith"
}
},
"attachments": [
{
"size": 44369,
"filename": "Screenshot 2021-02-12 at 10.44.45.png",
"mime_type": "image/png",
"url": "https://some-storage.s3.amazonaws.com/attachments/abc123.png"
}
]
}
}
},
{
"id": "107107309",
"type": "timeline_item",
"attributes": {
"item_type": "generic_card",
"at": "2021-02-12T07:49:14.539Z",
"data": {
"title": "Some title",
"content": "John Smith opened the incident email sent to john@smith.com.",
"links": [
"https://uptime.betterstack.com/team/1/team-members/1"
]
}
}
},
{
"id": "2470302-content-response",
"type": "timeline_item",
"attributes": {
"item_type": "response_item",
"at": "2021-02-12T06:42:25.905Z",
"data": {
"title": "Page response",
"content": "[\"Some response data\"]"
}
}
},
{
"id": "2107504",
"type": "timeline_item",
"attributes": {
"item_type": "payload",
"at": "2021-02-11T07:52:57.540Z",
"data": {
"title": "Datadog",
"content": "Datadog alert.",
"attachments": [
{
"size": 123456,
"filename": "File.png",
"mime_type": "image/png",
"url": "https://some-storage.s3.amazonaws.com/attachments/xyz123.png"
}
]
}
}
},
{
"id": "incident-started",
"type": "timeline_item",
"attributes": {
"item_type": "generic",
"at": "2021-02-10T04:02:57.755Z",
"data": {
"content": "Incident started.",
"links": [
]
}
}
}
]
}curl --request GET \
--url https://uptime.betterstack.com/api/v2/incidents/123456789/timeline \
--header "Authorization: Bearer $TOKEN"