---
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`

## Request

- Base URL: `` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/channel-ingress`
- Auth: none declared

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

## Changes

- **2026-08-07** `0ce2a9dec32d`: 1 info
  - added the required property `sources/items/routes/items/deliversInbound` to the response with the `200` status
- **2026-08-06** `c254043741e3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vellum-ai/apis/vellum-gateway-api/changes/v1/channel-ingress/get.md)

---

[API](https://skmtc.dev/vellum-ai/apis/vellum-gateway-api.md) - [All operations](https://skmtc.dev/vellum-ai/apis/vellum-gateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vellum-ai/apis/vellum-gateway-api/revisions/48d611686235?raw)