v1
latestOpenAPI 3.0.02026-07-141,4077,1665.2 MBEvents
Get a list of events
List endpoint returns events that match an events search query. Results are paginated similarly to logs.
Use this endpoint to see your latest events.
get/api/v2/events
Query parameters
filter[query]string
Search query following events syntax.
filter[from]string
Minimum timestamp for requested events, in milliseconds.
filter[to]string
Maximum timestamp for requested events, in milliseconds.
sort'timestamp' | '-timestamp'
The sort parameters when querying events.
Order of events in results.
page[cursor]string
List following results with a cursor provided in the previous query.
page[limit]integer
Maximum number of events in the response.
Response
OK
Example response
{
"data": [
{
"attributes": {
"attributes": {
"event_object": "Did you hear the news today?",
"evt": {
"id": "6509751066204996294",
"source_id": 36,
"type": "error_tracking_alert"
},
"monitor": {
"created_at": 1646318692000,
"tags": [
"environment:test"
]
},
"priority": "normal",
"service": "datadog-api",
"status": "info",
"tags": [
"environment:test"
],
"timestamp": 1652274265000,
"title": "Oh boy!"
},
"tags": [
"team:A"
],
"timestamp": "2019-01-02T09:42:36.320Z"
},
"id": "AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA",
"type": "event"
}
],
"links": {
"next": "https://app.datadoghq.com/api/v2/events?filter[query]=foo&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ=="
},
"meta": {
"elapsed": 132,
"page": {
"after": "eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ=="
},
"request_id": "MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR",
"status": "done",
"warnings": [
{
"code": "unknown_index",
"detail": "indexes: foo, bar",
"title": "One or several indexes are missing or invalid. Results hold data from the other indexes."
}
]
}
}