---
title: "List the org's collectors, or one fleet's, one page at a time"
method: GET
path: "/api/{org_id}/fleet/collectors"
tags: ["Fleet"]
---

# List the org's collectors, or one fleet's, one page at a time

`GET /api/{org_id}/fleet/collectors`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/fleet/collectors`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/fleet/collectors/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `org_id` string, required

## Query parameters

- `fleet` string
- `offset` integer
- `limit` integer

## Response `200`

Success

- CollectorList
  - `items` Collector[], required
    - `arch` string, nullable
    - `config` string, nullable
    - `config_version` integer, nullable
    - `delivery` 'assigned' | 'sent' | 'accepted' | 'running' | 'rejected': Derived when read from the assignment and the collector's reports.
    - `delivery_error` string, nullable
    - `distribution` string, nullable
    - `enrolled_at` integer, required: Epoch milliseconds.
    - `fleet` CollectorFleet, required: A fleet named by its public id; `name` is null once the fleet was deleted.
      - `id` string, required
      - `name` string, nullable
    - `hostname` string, nullable
    - `id` string, required
    - `last_connected_from` string, nullable: The connection's client address, as `ZO_HTTP_REAL_IP_SOURCE` resolves it.
    - `last_seen` integer, required: Epoch milliseconds.
    - `name` string, required: The nickname, or the host name when none was set.
    - `os` string, nullable
    - `outdated` boolean, required
    - `status` 'unknown' | 'online' | 'degraded' | 'offline', required: Derived when read from `last_seen` and the reported health, never stored.
    - `token_id` string, nullable
    - `version` string, nullable
  - `total` integer, required

## Other responses

- `403`: Forbidden

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)