---
title: "List a process by its ID"
method: GET
path: "/api/v3/process/{id}"
tags: ["v16.7.2"]
---

# List a process by its ID

`GET /api/v3/process/{id}`

List a process by its ID. Use the filter parameter to specifiy the level of detail of the output.

## Path parameters

- `id` string, required

## Query parameters

- `filter` string

## Response `200`

OK

- ApiProcess
  - `config` ApiProcessConfig
    - `autostart` boolean
    - `id` string
    - `input` ApiProcessConfigIO[], required
      - `address` string, required
      - `cleanup` ApiProcessConfigIOCleanup[]
        - `max_file_age_seconds` integer
        - `max_files` integer
        - `pattern` string, required
        - `purge_on_delete` boolean
      - `id` string
      - `options` string[]
    - `limits` ApiProcessConfigLimits
      - `cpu_usage` number
      - `memory_mbytes` integer
      - `waitfor_seconds` integer
    - `options` string[]
    - `output` ApiProcessConfigIO[], required
      - `address` string, required
      - `cleanup` ApiProcessConfigIOCleanup[]
        - `max_file_age_seconds` integer
        - `max_files` integer
        - `pattern` string, required
        - `purge_on_delete` boolean
      - `id` string
      - `options` string[]
    - `reconnect` boolean
    - `reconnect_delay_seconds` integer
    - `reference` string
    - `stale_timeout_seconds` integer
    - `type` 'ffmpeg' | ''
  - `created_at` integer
  - `id` string
  - `metadata` unknown
  - `reference` string
  - `report` ApiProcessReport
    - `created_at` integer
    - `history` ApiProcessReportHistoryEntry[]
      - `created_at` integer
      - `log` array[]
        - string[]
      - `prelude` string[]
    - `log` array[]
      - string[]
    - `prelude` string[]
  - `state` ApiProcessState
    - `command` string[]
    - `cpu_usage` number
    - `exec` string
    - `last_logline` string
    - `memory_bytes` integer
    - `order` string
    - `progress` ApiProgress
      - `bitrate_kbit` number — kbit/s
      - `drop` integer
      - `dup` integer
      - `fps` number
      - `frame` integer
      - `inputs` ApiProgressIO[]
        - `address` string
        - `avstream` ApiAVstream
          - `aqueue` integer
          - `drop` integer
          - `dup` integer
          - `duplicating` boolean
          - `enc` integer
          - `gop` string
          - `input` ApiAVstreamIO
            - `packet` integer
            - `size_kb` integer
            - `state` 'running' | 'idle'
            - `time` integer
          - `looping` boolean
          - `looping_runtime` integer
          - `output` ApiAVstreamIO
            - `packet` integer
            - `size_kb` integer
            - `state` 'running' | 'idle'
            - `time` integer
          - `queue` integer
        - `bitrate_kbit` number — kbit/s
        - `channels` integer
        - `codec` string
        - `coder` string
        - `extradata_size_bytes` integer — bytes
        - `format` string
        - `fps` number
        - `frame` integer
        - `framerate` ApiProgressIOFramerate
          - `avg` number
          - `max` number
          - `min` number
        - `height` integer
        - `id` string
        - `index` integer — General
        - `keyframe` integer
        - `layout` string
        - `packet` integer
        - `pix_fmt` string — Video
        - `pps` number
        - `q` number
        - `sampling_hz` integer — Audio
        - `size_kb` integer — kbytes
        - `stream` integer
        - `type` string
        - `width` integer
      - `outputs` ApiProgressIO[]
        - `address` string
        - `avstream` ApiAVstream
          - `aqueue` integer
          - `drop` integer
          - `dup` integer
          - `duplicating` boolean
          - `enc` integer
          - `gop` string
          - `input` ApiAVstreamIO
            - `packet` integer
            - `size_kb` integer
            - `state` 'running' | 'idle'
            - `time` integer
          - `looping` boolean
          - `looping_runtime` integer
          - `output` ApiAVstreamIO
            - `packet` integer
            - `size_kb` integer
            - `state` 'running' | 'idle'
            - `time` integer
          - `queue` integer
        - `bitrate_kbit` number — kbit/s
        - `channels` integer
        - `codec` string
        - `coder` string
        - `extradata_size_bytes` integer — bytes
        - `format` string
        - `fps` number
        - `frame` integer
        - `framerate` ApiProgressIOFramerate
          - `avg` number
          - `max` number
          - `min` number
        - `height` integer
        - `id` string
        - `index` integer — General
        - `keyframe` integer
        - `layout` string
        - `packet` integer
        - `pix_fmt` string — Video
        - `pps` number
        - `q` number
        - `sampling_hz` integer — Audio
        - `size_kb` integer — kbytes
        - `stream` integer
        - `type` string
        - `width` integer
      - `packet` integer
      - `q` number
      - `size_kb` integer — kbytes
      - `speed` number
      - `time` number
    - `reconnect_seconds` integer
    - `runtime_seconds` integer
  - `type` string
  - `updated_at` integer

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/datarhei/apis/datarhei-core-api.md) · [All operations](https://skmtc.net/datarhei/apis/datarhei-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datarhei/datarhei-core-api/versions/0197dcdcdd5a/schema)