---
title: "List"
method: GET
path: "/agent_ingresses"
tags: ["AgentIngresses"]
---

# List

`GET /agent_ingresses`

List all Agent Ingresses owned by this account

## Query parameters

- `before_id` string
- `limit` string
- `filter` string

## Headers

- `ngrok-version` integer, required

## Response `200`

List all Agent Ingresses owned by this account

- AgentIngressList
  - `ingresses` AgentIngress[] — the list of Agent Ingresses owned by this account
    - `id` string — unique Agent Ingress resource identifier
    - `uri` string — URI to the API resource of this Agent ingress
    - `description` string — human-readable description of the use of this Agent Ingress. optional, max 255 bytes.
    - `metadata` string — arbitrary user-defined machine-readable data of this Agent Ingress. optional, max 4096 bytes
    - `domain` string — the domain that you own to be used as the base domain name to generate regional agent ingress domains.
    - `ns_targets` string[] — a list of target values to use as the values of NS records for the domain property these values will delegate control over the domain to ngrok
    - `region_domains` string[] — a list of regional agent ingress domains that are subdomains of the value of domain this value may increase over time as ngrok adds more regions
    - `created_at` string — timestamp when the Agent Ingress was created, RFC 3339 format
    - `certificate_management_policy` AgentIngressCertPolicy
      - `authority` string — certificate authority to request certificates from. The only supported value is letsencrypt.
      - `private_key_type` string — type of private key to use when requesting certificates. Defaults to rsa, can be either rsa or ecdsa.
    - `certificate_management_status` AgentIngressCertStatus
      - `renews_at` string — timestamp when the next renewal will be requested, RFC 3339 format
      - `provisioning_job` AgentIngressCertJob
        - `error_code` string — if present, an error code indicating why provisioning is failing. It may be either a temporary condition (INTERNAL_ERROR), or a permanent one the user must correct (DNS_ERROR).
        - `msg` string — a message describing the current status or error
        - `started_at` string — timestamp when the provisioning job started, RFC 3339 format
        - `retries_at` string — timestamp when the provisioning job will be retried
  - `uri` string — URI of the Agent Ingress list API resource
  - `next_page_uri` string — URI of the next page, or null if there is no next page

---

[API](https://skmtc.net/ngrok/apis/ngrok-openapi.md) · [All operations](https://skmtc.net/ngrok/apis/ngrok-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ngrok/ngrok-openapi/versions/1994bbb04714/schema)