Skip to main content

Endpoints

List Endpoints

List all active endpoints on the account

Request

GET /endpoints

Example Request

curl \
-X GET \
-H "Authorization: Bearer {API_KEY}" \
-H "Ngrok-Version: 2" \
https://api.ngrok.com/endpoints

Response

Returns a 200 response on success

Example Response

{
"endpoints": [
{
"created_at": "2024-08-02T07:15:36Z",
"hostport": "f0083d6cb15e.ngrok.paid:443",
"id": "ep_2k5ojuJ8pGlbsVlOQ2lPe65SDs8",
"proto": "https",
"public_url": "https://f0083d6cb15e.ngrok.paid",
"tunnel": {
"id": "tn_2k5ojuJ8pGlbsVlOQ2lPe65SDs8",
"uri": "https://api.ngrok.com/tunnels/tn_2k5ojuJ8pGlbsVlOQ2lPe65SDs8"
},
"type": "ephemeral",
"updated_at": "2024-08-02T07:15:36Z"
},
{
"created_at": "2024-08-02T07:15:33Z",
"domain": {
"id": "rd_2k5ojOs6CTPouBB8JIi7D1rmwyD",
"uri": "https://api.ngrok.com/reserved_domains/rd_2k5ojOs6CTPouBB8JIi7D1rmwyD"
},
"edge": {
"id": "edgtls_2k5ojMmZRNYMInd6d6ZxOFrymH0",
"uri": "https://api.ngrok.com/edges/tls/edgtls_2k5ojMmZRNYMInd6d6ZxOFrymH0"
},
"hostport": "endpoint-example2.com:443",
"id": "ep_2k5ojYt5TK0EigEk2OqH1sjHaJb",
"proto": "tls",
"public_url": "tls://endpoint-example2.com",
"type": "edge",
"updated_at": "2024-08-02T07:15:33Z"
}
],
"next_page_uri": null,
"uri": "https://api.ngrok.com/endpoints"
}

Fields

NameTypeDescription
endpointsEndpointthe list of all active endpoints on this account
uristringURI of the endpoints list API resource
next_page_uristringURI of the next page, or null if there is no next page

Endpoint fields

NameTypeDescription
idstringunique endpoint resource identifier
regionstringidentifier of the region this endpoint belongs to
created_atstringtimestamp when the endpoint was created in RFC 3339 format
updated_atstringtimestamp when the endpoint was updated in RFC 3339 format
public_urlstringURL of the hostport served by this endpoint
protostringprotocol served by this endpoint. one of http, https, tcp, or tls
hostportstringhostport served by this endpoint (hostname:port)
typestringwhether the endpoint is ephemeral (served directly by an agent-initiated tunnel) or edge (served by an edge)
metadatastringuser-supplied metadata of the associated tunnel or edge object
domainRefthe domain reserved for this endpoint
tcp_addrRefthe address reserved for this endpoint
tunnelRefthe tunnel serving requests to this endpoint, if this is an ephemeral endpoint
edgeRefthe edge serving requests to this endpoint, if this is an edge endpoint

Ref fields

NameTypeDescription
idstringa resource identifier
uristringa uri for locating a resource

Get Endpoint

Get the status of an endpoint by ID

Request

GET /endpoints/{id}

Example Request

curl \
-X GET \
-H "Authorization: Bearer {API_KEY}" \
-H "Ngrok-Version: 2" \
https://api.ngrok.com/endpoints/ep_2k5ojuJ8pGlbsVlOQ2lPe65SDs8

Response

Returns a 200 response on success

Example Response

{
"created_at": "2024-08-02T07:15:36Z",
"hostport": "f0083d6cb15e.ngrok.paid:443",
"id": "ep_2k5ojuJ8pGlbsVlOQ2lPe65SDs8",
"proto": "https",
"public_url": "https://f0083d6cb15e.ngrok.paid",
"tunnel": {
"id": "tn_2k5ojuJ8pGlbsVlOQ2lPe65SDs8",
"uri": "https://api.ngrok.com/tunnels/tn_2k5ojuJ8pGlbsVlOQ2lPe65SDs8"
},
"type": "ephemeral",
"updated_at": "2024-08-02T07:15:36Z"
}

Fields

NameTypeDescription
idstringunique endpoint resource identifier
regionstringidentifier of the region this endpoint belongs to
created_atstringtimestamp when the endpoint was created in RFC 3339 format
updated_atstringtimestamp when the endpoint was updated in RFC 3339 format
public_urlstringURL of the hostport served by this endpoint
protostringprotocol served by this endpoint. one of http, https, tcp, or tls
hostportstringhostport served by this endpoint (hostname:port)
typestringwhether the endpoint is ephemeral (served directly by an agent-initiated tunnel) or edge (served by an edge)
metadatastringuser-supplied metadata of the associated tunnel or edge object
domainRefthe domain reserved for this endpoint
tcp_addrRefthe address reserved for this endpoint
tunnelRefthe tunnel serving requests to this endpoint, if this is an ephemeral endpoint
edgeRefthe edge serving requests to this endpoint, if this is an edge endpoint

Ref fields

NameTypeDescription
idstringa resource identifier
uristringa uri for locating a resource