> ## Documentation Index
> Fetch the complete documentation index at: https://hc.starbridge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Bridge

> Fetch the configuration of a single Bridge by ID — name, owner, filter type, current status, last-updated timestamp, and total row count. A Bridge watches for one type of buyer activity — RFPs, meetings, purchases, conferences, contact or job changes, or other signals — within a buyer-list scope, extracts a configurable set of column values when something matches, and stores each match as a row.

For the per-column schema (columnId, name, prompt, type, fieldFormat, etc.) needed to construct column-targeted filters in `listBridgeRows`, call `getBridgeColumnMetadata`.



## OpenAPI

````yaml https://core-http2-157602306522.us-central1.run.app/external/public/swagger/documentation.yaml get /api/external/bridge/{bridgeId}
openapi: 3.1.1
info:
  title: Starbridge External Public API
  version: '1.0'
servers:
  - url: https://dashboard.starbridge.ai
security: []
paths:
  /api/external/bridge/{bridgeId}:
    get:
      tags:
        - Bridges
        - External MCP
        - External API
      summary: Get Bridge
      description: >-
        Fetch the configuration of a single Bridge by ID — name, owner, filter
        type, current status, last-updated timestamp, and total row count. A
        Bridge watches for one type of buyer activity — RFPs, meetings,
        purchases, conferences, contact or job changes, or other signals —
        within a buyer-list scope, extracts a configurable set of column values
        when something matches, and stores each match as a row.


        For the per-column schema (columnId, name, prompt, type, fieldFormat,
        etc.) needed to construct column-targeted filters in `listBridgeRows`,
        call `getBridgeColumnMetadata`.
      operationId: getBridge
      parameters:
        - name: bridgeId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Bridge details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BridgeResponse'
        '400':
          description: Invalid request body or format
        '401':
          description: Missing or invalid authentication
        '403':
          description: Unauthorized to access resource or perform action
        '404':
          description: Resource not found
        '415':
          description: Unsupported media type or request body format
        '429':
          description: Rate limit exceeded
        '500':
          description: Internal server error
      security:
        - apiKey: []
components:
  schemas:
    BridgeResponse:
      type: object
      title: BridgeResponse
      required:
        - bridgeId
        - name
        - userId
        - filterType
        - status
        - updatedAt
      properties:
        bridgeId:
          type: string
          description: Unique identifier for the bridge
          format: uuid
        name:
          type: string
          description: Name of the bridge
        userId:
          type: string
          description: User ID who created and owns the bridge
        filterType:
          type: string
          description: Type of filter applied to the bridge
          enum:
            - RFP
            - Meeting
            - Purchase
            - Buyer
            - Contact
            - Signal
            - Conference
            - JobChange
            - SequenceBuyer
            - SequenceContact
            - SequenceJobChange
        status:
          type: string
          description: Current status of the bridge
          enum:
            - Initializing
            - Matching
            - Draft
            - Open
            - Failed
            - Deleting
        updatedAt:
          type: string
          description: >-
            Timestamp when a user last edited this bridge's configuration (name,
            columns, sharing). Does NOT indicate when new rows were added
        rowCount:
          type: integer
          description: Total number of rows in the bridge
  securitySchemes:
    apiKey:
      scheme: bearer
      description: HTTP Bearer Authentication
      type: http

````