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

---

[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)