---
title: "List"
method: GET
path: "/processor/list"
tags: ["processors"]
---

# List

`GET /processor/list`

List Processors and their latest runtime status for the caller's organization.

## Response `200`

Successful Response

- ProcessorListItemResponse[]
  - `id` string, uuid, required
  - `display_name` string, required
  - `description` string, nullable, required
  - `created_at` string, date-time, required
  - `status` ProcessorStatusResponse, required
    - `availability` 'ONLINE' | 'OFFLINE' | 'PENDING', required
    - `offline_reason` 'NO_VALID_CERTIFICATE' | 'CERTIFICATE_EXPIRED' | 'HEALTH_REPORT_STALE', required
    - `certificate_status` 'VALID' | 'EXPIRED' | 'UNAVAILABLE', required
    - `latest_report` ServiceStatusReportResponse, required
      - `deployment_id` string, nullable, required
      - `service` string, required
      - `boot_id` string, required
      - `report_seq` integer, required
      - `report_id` string, required
      - `reported_at` string, date-time, required
      - `received_at` string, date-time, required
      - `envelope_version` integer, required
      - `instance` string, required
      - `version` string, required
      - `start_time_unix` integer, required
      - `uptime_secs` integer, required
      - `rss_bytes` integer, nullable, required
      - `payload` ServiceStatusReportPayload, required — The reporter-owned, versioned payload stored without interpretation.
    - `report_category` 'NO_DATA_INGRESS' | 'INGRESS_PROCESSING_FAILED' | 'INGRESS_PROCESSED' | 'BACKPRESSURE', required
    - `backpressure` boolean, nullable, required

## Changes

> 57 revisions in range; 9 not diffed.

- **2026-09-23** `3da9c3d0385f` — 1 warning, 1 info
  - added the new `PENDING` enum value to the `items/status/availability` response property for the response status `200`
  - removed the `NO_HEALTH_REPORT` enum value from the `items/status/offline_reason/anyOf[subschema #1: ProcessorOfflineReason]/` response property for the response status `200`
- **2026-09-18** `af140c3c54d8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/traversal/apis/fastapi/changes/processor/list/get.md)

---

[API](https://skmtc.dev/traversal/apis/fastapi.md) · [All operations](https://skmtc.dev/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/traversal/apis/fastapi/revisions/c3bd9dec6c16?raw)