---
updatedAt: 2026-04-05T19:47:05.000Z
agentTools:
  siteIndex: https://docs.jfrog.com/llms.txt
  projectIndex: https://docs.jfrog.com/administration/llms.txt
---

# Get Bridge Client Debug Snapshot

Returns operational statistics and runtime information for all bridges configured on this Bridge Client instance, including active connections, request counts, and creation timestamps.

**Note:** In High Availability (HA) deployments, this endpoint returns information from the specific instance that handles the request.

**Security:** Requires Platform Admin privileges.


# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "JFrog Platform - Bridge API",
    "description": "Manage secure, encrypted connections between JFrog Platform Deployments (JPDs) in hybrid topologies. For more information, see [JFrog Bridge](https://docs.jfrog.com/administration/docs/manage-jfrog-bridges).\n\n**Note:** Bridges defined directly in `system.yaml` appear in the Bridges table but cannot be managed using the Platform interface or the Bridge APIs. Use only the JFrog Platform interface or the Bridge APIs to create and manage Bridges.\n\n**Authentication:** Access Tokens as bearer token in authorization header (`Authorization: Bearer <token>`).\n\n**Security:** Unless otherwise specified, all APIs require Platform Admin privileges.\n",
    "version": "1.0.0",
    "contact": {
      "name": "JFrog Support"
    }
  },
  "servers": [
    {
      "url": "https://{jfrog_url}",
      "description": "JFrog Platform Server",
      "variables": {
        "protocol": {
          "default": "https",
          "enum": [
            "http",
            "https"
          ]
        },
        "host": {
          "default": "demo.jfrog.io",
          "description": "JFrog Platform hostname"
        }
      }
    }
  ],
  "tags": [
    {
      "name": "Bridge Client",
      "description": "Manage bridge connections, configurations, and diagnostics on the Self-managed JPD."
    }
  ],
  "security": [
    {
      "AdminBearerAuth": []
    }
  ],
  "paths": {
    "/bridge-client/api/v1/bridges/debug": {
      "get": {
        "tags": [
          "Bridge Client"
        ],
        "summary": "Get Bridge Client Debug Snapshot",
        "description": "Returns operational statistics and runtime information for all bridges configured on this Bridge Client instance, including active connections, request counts, and creation timestamps.\n\n**Note:** In High Availability (HA) deployments, this endpoint returns information from the specific instance that handles the request.\n\n**Security:** Requires Platform Admin privileges.\n",
        "operationId": "getBridgeClientDebugSnapshot",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BridgeClientDebugResponse"
                },
                "example": {
                  "bridges": [
                    {
                      "id": "my-bridge-01",
                      "config": {
                        "type": "default",
                        "bridge_id": "my-bridge-01",
                        "remote": {
                          "url": "https://mycompany.jfrog.io",
                          "token": "<removed>"
                        },
                        "local": {
                          "url": "https://my-local-jpd.example.com"
                        },
                        "min_tunnels": 1,
                        "max_tunnels": 5
                      },
                      "active_connections": [
                        {
                          "id": "conn-abc123",
                          "active_streams": 2,
                          "created_at": "2024-01-31T12:00:00Z"
                        }
                      ],
                      "created_at": "2024-01-31T10:00:00Z"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized user"
          },
          "403": {
            "description": "Action not permitted for this account"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "AdminBearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Access Token with admin permissions as bearer token",
        "bearerFormat": "JWT"
      }
    },
    "schemas": {
      "BridgeConfigResponse": {
        "type": "object",
        "description": "Bridge configuration response (remote token is redacted)",
        "properties": {
          "type": {
            "type": "string",
            "description": "Tunnel type"
          },
          "bridge_id": {
            "type": "string",
            "description": "Bridge identifier"
          },
          "stopped": {
            "type": "boolean",
            "description": "Whether the bridge is stopped"
          },
          "last_updated_at": {
            "type": "integer",
            "format": "int64",
            "description": "Timestamp of last configuration update (Unix epoch)"
          },
          "remote": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "description": "Remote Bridge Server URL"
              },
              "token": {
                "type": "string",
                "description": "Remote token (redacted as \"<removed>\" for security)"
              },
              "insecure": {
                "type": "boolean",
                "description": "Allow insecure connections"
              },
              "proxy": {
                "type": "object",
                "properties": {
                  "enabled": {
                    "type": "boolean"
                  },
                  "cache_expiration_secs": {
                    "type": "integer"
                  },
                  "key": {
                    "type": "string"
                  },
                  "scheme_override": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "local": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "description": "Local Bridge Client URL"
              },
              "anonymous_endpoints": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "dial_timeout_secs": {
                "type": "integer"
              }
            }
          },
          "min_tunnels": {
            "type": "integer"
          },
          "max_tunnels": {
            "type": "integer"
          },
          "target_usage": {
            "type": "object",
            "properties": {
              "low": {
                "type": "integer"
              },
              "high": {
                "type": "integer"
              }
            }
          },
          "jobs": {
            "type": "object",
            "properties": {
              "tunnel_creation": {
                "type": "object",
                "properties": {
                  "interval_minutes": {
                    "type": "integer"
                  }
                }
              },
              "tunnel_closing": {
                "type": "object",
                "properties": {
                  "cron_expr": {
                    "type": "string"
                  },
                  "allow_close_used_tunnels": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        }
      },
      "BridgeClientDebugResponse": {
        "type": "object",
        "description": "Debug information for all bridges on Bridge Client",
        "properties": {
          "bridges": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Bridge identifier"
                },
                "config": {
                  "$ref": "#/components/schemas/BridgeConfigResponse"
                },
                "active_connections": {
                  "type": "array",
                  "description": "List of active tunnel connections",
                  "items": {
                    "$ref": "#/components/schemas/ConnStats"
                  }
                },
                "created_at": {
                  "type": "string",
                  "description": "Bridge creation timestamp"
                }
              }
            }
          }
        }
      },
      "ConnStats": {
        "type": "object",
        "description": "Connection statistics for a single tunnel connection",
        "properties": {
          "id": {
            "type": "string",
            "description": "Connection identifier"
          },
          "active_streams": {
            "type": "integer",
            "description": "Number of active streams on this connection"
          },
          "created_at": {
            "type": "string",
            "description": "Connection creation timestamp"
          },
          "last_dialed_at": {
            "type": "string",
            "description": "Timestamp of the last dial attempt (optional)"
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": false
  }
}
```