---
title: "Get"
method: GET
path: "/agent_ingresses/{id}"
tags: ["AgentIngresses"]
---

# Get

`GET /agent_ingresses/{id}`

Get the details of an Agent Ingress by ID.

## Path parameters

- `id` string, required

## Headers

- `ngrok-version` integer, required

## Response `200`

Get the details of an Agent Ingress by ID.

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

## Other responses

- `4XX` — An error. The body carries a machine-readable error_code and a human-readable msg; every code is documented at https://ngrok.com/docs/errors. A 429 with error code ERR_NGROK_226 means the account exceeded the documented request-rate limit.
- `5XX` — An error. The body carries a machine-readable error_code and a human-readable msg; every code is documented at https://ngrok.com/docs/errors. A 429 with error code ERR_NGROK_226 means the account exceeded the documented request-rate limit.

---

[API](https://skmtc.dev/ngrok/apis/ngrok-openapi.md) · [All operations](https://skmtc.dev/ngrok/apis/ngrok-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ngrok/ngrok-openapi/revisions/c697539ac350/schema)