ListLogsGet
Search, filter, and retrieve logs from Datadog’s observability platform using query parameters like timestamp, indexes, and storage tier. Paginate results for efficient log management.
Instructions
List endpoint returns logs that match a log search query. .
Use this endpoint to search and filter your logs.
If you are considering archiving logs for your organization, consider use of the Datadog archive capabilities instead of the log list API. See .
Query Parameters:
filter[query]: Search query following logs syntax.
filter[indexes]: For customers with multiple indexes, the indexes to search. Defaults to '*' which means all indexes
filter[from]: Minimum timestamp for requested logs.
filter[to]: Maximum timestamp for requested logs.
filter[storage_tier]: Specifies the storage type to be used
sort: Order of logs in results.
page[cursor]: List following results with a cursor provided in the previous query.
page[limit]: Maximum number of logs in the response.
Responses:
200 (Success): OK
Content-Type:
application/jsonResponse Properties:
data: Array of logs matching the request.
Example:
{
"data": [
"unknown_type"
],
"links": "unknown_type",
"meta": "unknown_type"
}400: Bad Request
Content-Type:
application/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"Bad Request"
]
}403: Not Authorized
Content-Type:
application/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"Bad Request"
]
}429: Too many requests
Content-Type:
application/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"Bad Request"
]
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filter[from] | No | Minimum timestamp for requested logs. | |
| filter[indexes] | No | For customers with multiple indexes, the indexes to search. Defaults to '*' which means all indexes | |
| filter[query] | No | Search query following logs syntax. | |
| filter[storage_tier] | No | Specifies storage type as indexes, online-archives or flex | indexes |
| filter[to] | No | Maximum timestamp for requested logs. | |
| page[cursor] | No | List following results with a cursor provided in the previous query. | |
| page[limit] | No | Maximum number of logs in the response. | |
| sort | No | Sort parameters when querying logs. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Array of logs matching the request. | |
| meta | No | ||
| links | No |