---
title: "List tracers for a specific agent"
method: GET
path: "/api/unstable/fleet/agents/{agent_key}/tracers"
tags: ["Fleet Automation"]
---

# List tracers for a specific agent

`GET /api/unstable/fleet/agents/{agent_key}/tracers`

Retrieve a paginated list of tracers for a specific agent.

This endpoint returns tracers associated with a given agent key, identified by the
agent's hostname. Use this to discover telemetry-derived service names for a particular host.

## Path parameters

- `agent_key` string, required

## Query parameters

- `page_number` integer
- `page_size` integer
- `sort_attribute` string
- `sort_descending` boolean

## Response `200`

OK

- FleetTracersResponse — Response containing a paginated list of fleet tracers.
  - `data` FleetTracersResponseData, required — The response data containing status and tracers array.
    - `attributes` FleetTracersResponseDataAttributes, required — Attributes of the fleet tracers response containing the list of tracers.
      - `tracers` FleetTracerAttributes[] — Array of tracers matching the query criteria.
        - `env` string — The environment the tracer is reporting from.
        - `hostname` string — The hostname where the tracer is running.
        - `language` string — The programming language of the traced application.
        - `language_version` string — The version of the programming language runtime.
        - `remote_config_status` string — The remote configuration status of the tracer.
        - `runtime_ids` string[] — Runtime identifiers for the tracer instances.
        - `service` string — The telemetry-derived service name reported by the tracer.
        - `service_hostname` string — The service hostname reported by the tracer.
        - `service_version` string — The version of the traced service.
        - `tracer_version` string — The version of the Datadog tracer library.
    - `id` string, required — Status identifier.
    - `type` string, required — Resource type.
  - `meta` FleetTracersResponseMeta — Metadata for the list of tracers response.
    - `total_filtered_count` integer — Total number of tracers matching the filter criteria across all pages.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)