ListSpansGet

Retrieve and paginate spans matching a specific search query using timestamp filters, sorting, and cursor-based navigation to analyze and monitor observability data efficiently.

Instructions

List endpoint returns spans that match a span search query. Results are paginated.

Use this endpoint to see your latest spans. This endpoint is rate limited to 300 requests per hour.

Query Parameters:

filter[query]: Search query following spans syntax.
filter[from]: Minimum timestamp for requested spans. Supports date-time ISO8601, date math, and regular timestamps (milliseconds).
filter[to]: Maximum timestamp for requested spans. Supports date-time ISO8601, date math, and regular timestamps (milliseconds).
sort: Order of spans in results.
page[cursor]: List following results with a cursor provided in the previous query.
page[limit]: Maximum number of spans in the response.

Responses:

200 (Success): OK
- Content-Type: application/json
- Response Properties:
  - data: Array of spans matching the request.
- Example:

{
  "data": [
    "unknown_type"
  ],
  "links": "unknown_type",
  "meta": "unknown_type"
}

400: Bad Request.
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

{
  "errors": [
    "unknown_type"
  ]
}

403: Forbidden: Access denied.
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

{
  "errors": [
    "unknown_type"
  ]
}

422: Unprocessable Entity.
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

{
  "errors": [
    "unknown_type"
  ]
}

429: Too many requests: The rate limit set by the API has been exceeded.
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

{
  "errors": [
    "unknown_type"
  ]
}

Input Schema

Name	Required	Description
`filter[from]`	No	Minimum timestamp for requested spans. Supports date-time ISO8601, date math, and regular timestamps (milliseconds).
`filter[query]`	No	Search query following spans syntax.
`filter[to]`	No	Maximum timestamp for requested spans. Supports date-time ISO8601, date math, and regular timestamps (milliseconds).
`page[cursor]`	No	List following results with a cursor provided in the previous query.
`page[limit]`	No	Maximum number of spans in the response.
`sort`	No	Sort parameters when querying spans.

Input Schema (JSON Schema)

{
  "properties": {
    "filter[from]": {
      "description": "Minimum timestamp for requested spans. Supports date-time ISO8601, date math, and regular timestamps (milliseconds).",
      "type": "string"
    },
    "filter[query]": {
      "description": "Search query following spans syntax.",
      "type": "string"
    },
    "filter[to]": {
      "description": "Maximum timestamp for requested spans. Supports date-time ISO8601, date math, and regular timestamps (milliseconds).",
      "type": "string"
    },
    "page[cursor]": {
      "description": "List following results with a cursor provided in the previous query.",
      "type": "string"
    },
    "page[limit]": {
      "default": 10,
      "description": "Maximum number of spans in the response.",
      "format": "int32",
      "maximum": 1000,
      "type": "integer"
    },
    "sort": {
      "description": "Sort parameters when querying spans.",
      "enum": [
        "timestamp",
        "-timestamp"
      ],
      "type": "string",
      "x-enum-varnames": [
        "TIMESTAMP_ASCENDING",
        "TIMESTAMP_DESCENDING"
      ]
    }
  },
  "required": [],
  "type": "object"
}

Datadog MCP Server

ListSpansGet

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Datadog MCP Server

Related Tools

MCP directory API