List route
List route
which*stringRoute name
OK
application/json- response
access_log?|nullagent?stringalias?stringAlias is route lookup key.
Supported HTTP host-match forms:
- short alias: "app"
- FQDN alias: "app.example.com"
- leading-label wildcard alias: "*.example.com"
Wildcard aliases match exactly one leftmost label and are checked only after normal exact/domain lookup misses, preserving the fast path for exact routes.
bind?string|nullcontainer?|Docker only
disable_compression?booleanexcluded?boolean|nullexcluded_reason?string|nullhealth?for swagger
healthcheck?|null on load-balancer routes
homepage?host?stringidlewatcher?|nullinbound_mtls_profile?stringHTTP-based routes only: must match a configured inbound_mtls_profiles entry and is ignored when entrypoint.inbound_mtls_profile is set
index?stringIndex file to serve for single-page app mode
load_balance?|nulllurl?string|nullmax_conns_per_host?integermiddlewares?|nullno_tls_verify?booleanport?provider?|for backward compatibility
proxmox?|nullpublic_urls?array<string>|Public HTTP URLs derived from runtime domains and listeners
purl?stringrelay_proxy_protocol_header?booleanTCP only: relay PROXY protocol header to the destination
response_header_timeout?integerroot?stringrule_file?string|nullrules?array<>|nullscheme?string"http""https""h2c""tcp""udp""fileserver"spa?booleanSingle-page app mode: serves index for non-existent paths
ssl_certificate?stringPath to client certificate
ssl_certificate_key?stringPath to client certificate key
ssl_protocols?array<string>Allowed TLS protocols
ssl_server_name?stringSSL/TLS proxy options (nginx-like)
ssl_trusted_certificate?stringPath to trusted CA certificates
tls_termination?booleanTCP only: terminate inbound TLS on the shared HTTPS listener before proxying plaintext to the destination
curl -X GET 'https://example.com/api/v1/route/string'{ "access_log": { "fields": { "cookies": { "config": { "property1": "keep", "property2": "keep" }, "default": "keep" }, "headers": { "config": { "property1": "keep", "property2": "keep" }, "default": "keep" }, "query": { "config": { "property1": "keep", "property2": "keep" }, "default": "keep" } }, "filters": { "cidr": { "negative": true, "values": [ { "ip": [ 0 ], "mask": [ 0 ] } ] }, "headers": { "negative": true, "values": [ { "key": "string", "value": "string" } ] }, "host": { "negative": true, "values": [ "string" ] }, "method": { "negative": true, "values": [ "string" ] }, "status_codes": { "negative": true, "values": [ { "end": 0, "start": 0 } ] } }, "format": "common", "path": "string", "retention": { "days": 0, "keep_size": 0, "last": 0 }, "rotate_interval": 0, "stdout": true }, "agent": "string", "alias": "string", "bind": "string", "container": { "agent": { "addr": "string", "name": "string", "runtime": "docker", "supports_tcp_stream": true, "supports_udp_stream": true, "version": "string" }, "aliases": [ "string" ], "container_id": "string", "container_name": "string", "docker_cfg": { "tls": { "ca_file": "string", "cert_file": "string", "key_file": "string" }, "url": "string" }, "errors": "string", "exclude": "none", "idlewatcher_config": { "depends_on": [ "string" ], "docker": { "container_id": "string", "container_name": "string", "docker_cfg": { "tls": { "ca_file": "string", "cert_file": "string", "key_file": "string" }, "url": "string" } }, "idle_timeout": -9223372036854776000, "no_loading_page": true, "notify": { "to": [ "string" ] }, "proxmox": { "node": "string", "vmid": 0 }, "start_endpoint": "string", "stop_method": "pause", "stop_signal": "string", "stop_timeout": -9223372036854776000, "wake_timeout": -9223372036854776000 }, "image": { "author": "string", "name": "string", "sha256": "string", "tag": "string", "version": "string" }, "is_explicit": true, "is_host_network_mode": true, "labels": { "property1": "string", "property2": "string" }, "mounts": { "property1": "string", "property2": "string" }, "network": "string", "private_hostname": "string", "private_ports": { "property1": { "IP": "string", "PrivatePort": 0, "PublicPort": 0, "Type": "string" }, "property2": { "IP": "string", "PrivatePort": 0, "PublicPort": 0, "Type": "string" } }, "public_hostname": "string", "public_ports": { "property1": { "IP": "string", "PrivatePort": 0, "PublicPort": 0, "Type": "string" }, "property2": { "IP": "string", "PrivatePort": 0, "PublicPort": 0, "Type": "string" } }, "running": true, "state": "created" }, "disable_compression": true, "excluded": true, "excluded_reason": "string", "health": { "config": { "disable": true, "interval": 0, "path": "string", "retries": 0, "timeout": 0, "use_get": true }, "detail": "string", "extra": { "config": { "link": "string", "mode": "", "options": { "property1": null, "property2": null }, "sticky": true, "sticky_max_age": -9223372036854776000, "weight": 0 }, "pool": { "property1": null, "property2": null } }, "lastSeen": 0, "latency": 0, "name": "string", "started": 0, "status": "unknown", "uptime": 0, "url": "string" }, "healthcheck": { "disable": true, "interval": 0, "path": "string", "retries": 0, "timeout": 0, "use_get": true }, "homepage": { "category": "string", "description": "string", "favorite": true, "icon": "string", "name": "string", "show": true, "url": "string", "widget_config": { "config": null, "provider": "string" } }, "host": "string", "idlewatcher": { "depends_on": [ "string" ], "docker": { "container_id": "string", "container_name": "string", "docker_cfg": { "tls": { "ca_file": "string", "cert_file": "string", "key_file": "string" }, "url": "string" } }, "idle_timeout": -9223372036854776000, "no_loading_page": true, "notify": { "to": [ "string" ] }, "proxmox": { "node": "string", "vmid": 0 }, "start_endpoint": "string", "stop_method": "pause", "stop_signal": "string", "stop_timeout": -9223372036854776000, "wake_timeout": -9223372036854776000 }, "inbound_mtls_profile": "string", "index": "string", "load_balance": { "link": "string", "mode": "", "options": { "property1": null, "property2": null }, "sticky": true, "sticky_max_age": -9223372036854776000, "weight": 0 }, "lurl": "string", "max_conns_per_host": 0, "middlewares": { "property1": { "property1": null, "property2": null }, "property2": { "property1": null, "property2": null } }, "no_tls_verify": true, "port": { "listening": 0, "proxy": 0 }, "provider": "string", "proxmox": { "files": [ "string" ], "node": "string", "services": [ "string" ], "vmid": 0, "vmname": "string" }, "public_urls": [ "string" ], "purl": "string", "relay_proxy_protocol_header": true, "response_header_timeout": 0, "root": "string", "rule_file": "string", "rules": [ { "do": "string", "name": "string", "on": "string" } ], "scheme": "http", "spa": true, "ssl_certificate": "string", "ssl_certificate_key": "string", "ssl_protocols": [ "string" ], "ssl_server_name": "string", "ssl_trusted_certificate": "string", "tls_termination": true}