Sign in
Traefik Discovery

List every container adopted from Traefik labels, plus the labelled containers that were found and rejected.

Changed on
get/traefik-discovery/routes

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/traefik-discovery/routes
  • Auth: HTTP bearer

Query parameters

pageinteger

Page number (default: 1)

page_sizeinteger

Page size (default: 20, max: 100)

Response

Discovered routes and unresolved host conflicts

discovery_runningboolean required

false when the watcher isn't running, so a client can explain an empty list as "discovery is off" rather than "nothing was found".

pageinteger required
page_sizeinteger required
totalinteger required

Example response

{
  "routes": [
    {
      "created_at": "2026-01-01T00:00:00Z",
      "last_seen_at": "2026-01-01T00:00:00Z",
      "tls_certificate": {
        "authorized_at": "2026-01-01T00:00:00Z",
        "container_drift_detected_at": "2026-01-01T00:00:00Z",
        "imported_at": "2026-01-01T00:00:00Z"
      },
      "updated_at": "2026-01-01T00:00:00Z"
    }
  ]
}

Changes

  • 4b228ebed583Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 1dc3e6788214Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status