---
title: "Retrieve list of all recorders"
method: GET
path: "/recorder"
tags: ["recorder"]
---

# Retrieve list of all recorders

`GET /recorder`

## Response `200`

Success

- Recorder[]
  - `spec` RecorderSpec — Configuration of a recorder
    - `id` integer, required — Unique identification
    - `capture-length` integer — Maximum packet length or zero for full packet length
    - `filters` RecorderFilter[], required — List of wildcard filters for given recorder
      - `src-prefix` string — Layer 3 source CIDR
      - `src-port` string — Layer 4 source port, zero (or in future range)
      - `dst-prefix` string — Layer 3 destination CIDR
      - `dst-port` string — Layer 4 destination port, zero (or in future range)
      - `protocol` 'TCP' | 'UDP' | 'SCTP' | 'ANY' — Layer 4 protocol
  - `status` RecorderStatus — Configuration of a recorder
    - `realized` RecorderSpec — Configuration of a recorder
      - `id` integer, required — Unique identification
      - `capture-length` integer — Maximum packet length or zero for full packet length
      - `filters` RecorderFilter[], required — List of wildcard filters for given recorder
        - `src-prefix` string — Layer 3 source CIDR
        - `src-port` string — Layer 4 source port, zero (or in future range)
        - `dst-prefix` string — Layer 3 destination CIDR
        - `dst-port` string — Layer 4 destination port, zero (or in future range)
        - `protocol` 'TCP' | 'UDP' | 'SCTP' | 'ANY' — Layer 4 protocol

## Changes

- **2024-09-03** (v1) `5b32623f4b87` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/cilium/apis/cilium-api/changes/recorder/get.md)

---

[API](https://skmtc.dev/cilium/apis/cilium-api.md) · [All operations](https://skmtc.dev/cilium/apis/cilium-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cilium/cilium-api/revisions/5b32623f4b87/schema)