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-05-23T20:36:17Z",
			"domain": {
				"id": "rd_2gsqLW6i4R9cdQZN4ynj3tvf9iz",
				"uri": "https://api.ngrok.com/reserved_domains/rd_2gsqLW6i4R9cdQZN4ynj3tvf9iz"
			},
			"edge": {
				"id": "edgtls_2gsqLXIpfCgn5Hd18qqCs3w7yM1",
				"uri": "https://api.ngrok.com/edges/tls/edgtls_2gsqLXIpfCgn5Hd18qqCs3w7yM1"
			},
			"hostport": "endpoint-example2.com:443",
			"id": "ep_2gsqLbwODZsZ0jCfAjZoajtyjf6",
			"proto": "tls",
			"public_url": "tls://endpoint-example2.com",
			"type": "edge",
			"updated_at": "2024-05-23T20:36:17Z"
		},
		{
			"created_at": "2024-05-23T20:36:17Z",
			"hostport": "069c4eaef510.ngrok.paid:443",
			"id": "ep_2gsqLZLkWGLvytPbUYgUk64Wa0a",
			"proto": "https",
			"public_url": "https://069c4eaef510.ngrok.paid",
			"tunnel": {
				"id": "tn_2gsqLZLkWGLvytPbUYgUk64Wa0a",
				"uri": "https://api.ngrok.com/tunnels/tn_2gsqLZLkWGLvytPbUYgUk64Wa0a"
			},
			"type": "ephemeral",
			"updated_at": "2024-05-23T20:36:17Z"
		}
	],
	"next_page_uri": null,
	"uri": "https://api.ngrok.com/endpoints"
}

Fields

Name	Type	Description
endpoints	Endpoint	the list of all active endpoints on this account
uri	string	URI of the endpoints list API resource
next_page_uri	string	URI of the next page, or null if there is no next page

Endpoint fields

Name	Type	Description
id	string	unique endpoint resource identifier
region	string	identifier of the region this endpoint belongs to
created_at	string	timestamp when the endpoint was created in RFC 3339 format
updated_at	string	timestamp when the endpoint was updated in RFC 3339 format
public_url	string	URL of the hostport served by this endpoint
proto	string	protocol served by this endpoint. one of http, https, tcp, or tls
hostport	string	hostport served by this endpoint (hostname:port)
type	string	whether the endpoint is ephemeral (served directly by an agent-initiated tunnel) or edge (served by an edge)
metadata	string	user-supplied metadata of the associated tunnel or edge object
domain	Ref	the domain reserved for this endpoint
tcp_addr	Ref	the address reserved for this endpoint
tunnel	Ref	the tunnel serving requests to this endpoint, if this is an ephemeral endpoint
edge	Ref	the edge serving requests to this endpoint, if this is an edge endpoint

Ref fields

Name	Type	Description
id	string	a resource identifier
uri	string	a 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_2gsqLbwODZsZ0jCfAjZoajtyjf6

Response

Returns a 200 response on success

Example Response

{
	"created_at": "2024-05-23T20:36:17Z",
	"domain": {
		"id": "rd_2gsqLW6i4R9cdQZN4ynj3tvf9iz",
		"uri": "https://api.ngrok.com/reserved_domains/rd_2gsqLW6i4R9cdQZN4ynj3tvf9iz"
	},
	"edge": {
		"id": "edgtls_2gsqLXIpfCgn5Hd18qqCs3w7yM1",
		"uri": "https://api.ngrok.com/edges/tls/edgtls_2gsqLXIpfCgn5Hd18qqCs3w7yM1"
	},
	"hostport": "endpoint-example2.com:443",
	"id": "ep_2gsqLbwODZsZ0jCfAjZoajtyjf6",
	"proto": "tls",
	"public_url": "tls://endpoint-example2.com",
	"type": "edge",
	"updated_at": "2024-05-23T20:36:17Z"
}

Fields

Name	Type	Description
id	string	unique endpoint resource identifier
region	string	identifier of the region this endpoint belongs to
created_at	string	timestamp when the endpoint was created in RFC 3339 format
updated_at	string	timestamp when the endpoint was updated in RFC 3339 format
public_url	string	URL of the hostport served by this endpoint
proto	string	protocol served by this endpoint. one of http, https, tcp, or tls
hostport	string	hostport served by this endpoint (hostname:port)
type	string	whether the endpoint is ephemeral (served directly by an agent-initiated tunnel) or edge (served by an edge)
metadata	string	user-supplied metadata of the associated tunnel or edge object
domain	Ref	the domain reserved for this endpoint
tcp_addr	Ref	the address reserved for this endpoint
tunnel	Ref	the tunnel serving requests to this endpoint, if this is an ephemeral endpoint
edge	Ref	the edge serving requests to this endpoint, if this is an edge endpoint

Ref fields

Name	Type	Description
id	string	a resource identifier
uri	string	a uri for locating a resource