---
title: "Retrieve configuration of a recorder"
method: GET
path: "/recorder/{id}"
tags: ["recorder"]
---

# Retrieve configuration of a recorder

`GET /recorder/{id}`

## Path parameters

- `id` integer, required

## Response `200`

Success

- Recorder — Collection of wildcard filters for pcap 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

## Other responses

- `404` — Recorder not found

## Changes

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

[Change history](https://skmtc.dev/cilium/apis/cilium-api/changes/recorder/:id/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)