> ## 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.

# List Bridges

> List the saved Bridges (monitoring definitions) in the organization. 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. Use this to discover available Bridges and their identifiers.

Filter by `query` (name substring), `filterType`, `createdByUserId`, `userIdsHaveAccessTo`, or `buyerListId`. To paginate, start at `pageNumber=1` and increment until `pageNumber == totalPages`. For the columns defined on a specific Bridge, call `getBridgeColumnMetadata` — column metadata is no longer returned inline by this endpoint.



## OpenAPI

````yaml https://core-http2-157602306522.us-central1.run.app/external/public/swagger/documentation.yaml get /api/external/bridge
openapi: 3.1.1
info:
  title: Starbridge External Public API
  version: '1.0'
servers:
  - url: https://dashboard.starbridge.ai
security: []
paths:
  /api/external/bridge:
    get:
      tags:
        - Bridges
        - External MCP
        - External API
      summary: List Bridges
      description: >-
        List the saved Bridges (monitoring definitions) in the organization. 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. Use this to
        discover available Bridges and their identifiers.


        Filter by `query` (name substring), `filterType`, `createdByUserId`,
        `userIdsHaveAccessTo`, or `buyerListId`. To paginate, start at
        `pageNumber=1` and increment until `pageNumber == totalPages`. For the
        columns defined on a specific Bridge, call `getBridgeColumnMetadata` —
        column metadata is no longer returned inline by this endpoint.
      operationId: listBridges
      parameters:
        - name: sortField
          in: query
          schema:
            type: string
            default: Name
            enum:
              - Name
              - RowsCount
              - Type
              - CreatedBy
              - CreditUsage
              - SharedWith
              - LastUpdatedByUser
              - CreatedAt
        - name: sortDirection
          in: query
          schema:
            type: string
            default: ASC
            enum:
              - ASC
              - DESC
        - name: query
          in: query
          description: Filter by bridge name (substring match)
          schema:
            type: string
        - name: viewMode
          in: query
          schema:
            type: string
        - name: folderId
          in: query
          schema:
            type: string
        - name: pageNumber
          in: query
          description: Page number, 1-based. Minimum 1.
          schema:
            type: integer
            default: '1'
        - name: pageSize
          in: query
          description: Page size. Must be > 0 and <= 100. Prefer <= 20.
          schema:
            type: integer
            default: '10'
        - name: filterType
          in: query
          description: Bridge filter type(s)
          schema:
            type: array
            items:
              type: string
              enum:
                - RFP
                - Meeting
                - Purchase
                - Buyer
                - Contact
                - Signal
                - Conference
                - JobChange
                - SequenceBuyer
                - SequenceContact
                - SequenceJobChange
          style: form
          explode: false
        - name: createdByUserId
          in: query
          description: User ID(s) of the creator(s)
          schema:
            type: array
            items:
              type: string
          style: form
          explode: false
        - name: userIdsHaveAccessTo
          in: query
          schema:
            type: array
            items:
              type: string
          style: form
          explode: false
        - name: buyerListId
          in: query
          description: Buyer list ID(s) set up for the bridges
          schema:
            type: array
            items:
              type: string
              format: uuid
          style: form
          explode: false
      responses:
        '200':
          description: Paginated list of bridges
          content:
            application/json:
              schema:
                type: object
                required:
                  - pageNumber
                  - pageSize
                  - totalItems
                  - totalPages
                  - result
                properties:
                  pageNumber:
                    type: integer
                  pageSize:
                    type: integer
                  totalItems:
                    type: integer
                  totalPages:
                    type: integer
                  result:
                    type: array
                    items:
                      $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

````