---
title: "List ingress declarations and their approval state"
method: GET
path: "/v1/channel-ingress"
tags: ["channel-ingress"]
---

# List ingress declarations and their approval state

`GET /v1/channel-ingress`

Every declaration the gateway can see, each with the digest a guardian would approve, the public paths it would open, and the credential its signatures are verified against. This is the only way to learn that a declaration is waiting: on the public surface a route held back by approval 404s exactly like one nobody declared.

## Response `200`

Successful response

- object
  - `sources` object[], required
    - `source` string, required
    - `state` 'approved' | 'pending', required
    - `digest` string, required
    - `approvedAt` number
    - `approvedDigest` string
    - `routes` object[], required
      - `path` string, required
      - `publicPath` string, required
      - `kind` string, required
      - `signer` string, required
      - `handshake` string, required
      - `description` string, required
      - `credential` string, required
      - `served` boolean, required
      - `deliversInbound` boolean, required
      - `verification` object
        - `algorithm` string, required
        - `signatureHeader` string, required
  - `problems` object[], required
    - `source` string, required
    - `reason` string, required

---

[API](https://skmtc.net/vellum-ai/apis/vellum-gateway-api.md) · [All operations](https://skmtc.net/vellum-ai/apis/vellum-gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vellum-ai/vellum-gateway-api/revisions/0ce2a9dec32d/schema)