Search logs

POST {{baseUrl}}/api/v2/logs/events/search

List endpoint returns logs that match a log search query. Results are paginated.

Use this endpoint to build complex logs filtering and search.

If you are considering archiving logs for your organization, consider use of the Datadog archive capabilities instead of the log list API. See Datadog Logs Archive documentation.

Request Body

{"filter"=>{"from"=>"now-15m", "indexes"=>["*"], "query"=>"*", "storage_tier"=>"indexes", "to"=>"now"}, "options"=>{"timeOffset"=>"<long>", "timezone"=>"UTC"}, "page"=>{"cursor"=>"<string>", "limit"=>10}, "sort"=>"timestamp"}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;data&quot;:[{&quot;attributes&quot;:{&quot;attributes&quot;:{&quot;consectetur__9&quot;:{},&quot;aliquip_43&quot;:{}},&quot;host&quot;:&quot;\u003cstring\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;,&quot;service&quot;:&quot;\u003cstring\u003e&quot;,&quot;status&quot;:&quot;\u003cstring\u003e&quot;,&quot;tags&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;timestamp&quot;:&quot;\u003cdateTime\u003e&quot;},&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;log&quot;},{&quot;attributes&quot;:{&quot;attributes&quot;:{&quot;nisia4a&quot;:{},&quot;dolor4&quot;:{}},&quot;host&quot;:&quot;\u003cstring\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;,&quot;service&quot;:&quot;\u003cstring\u003e&quot;,&quot;status&quot;:&quot;\u003cstring\u003e&quot;,&quot;tags&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;timestamp&quot;:&quot;\u003cdateTime\u003e&quot;},&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;log&quot;}],&quot;links&quot;:{&quot;next&quot;:&quot;\u003cstring\u003e&quot;},&quot;meta&quot;:{&quot;elapsed&quot;:&quot;\u003clong\u003e&quot;,&quot;page&quot;:{&quot;after&quot;:&quot;\u003cstring\u003e&quot;},&quot;request_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;status&quot;:&quot;done&quot;,&quot;warnings&quot;:[{&quot;code&quot;:&quot;\u003cstring\u003e&quot;,&quot;detail&quot;:&quot;\u003cstring\u003e&quot;,&quot;title&quot;:&quot;\u003cstring\u003e&quot;},{&quot;code&quot;:&quot;\u003cstring\u003e&quot;,&quot;detail&quot;:&quot;\u003cstring\u003e&quot;,&quot;title&quot;:&quot;\u003cstring\u003e&quot;}]}}