---
title: "List Bridges"
method: GET
path: "/api/external/bridge"
tags: ["Bridges", "External MCP", "External API"]
---

# List Bridges

`GET /api/external/bridge`

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.

## Query parameters

- `sortField` 'Name' | 'RowsCount' | 'Type' | 'CreatedBy' | 'CreditUsage' | 'SharedWith' | 'LastUpdatedByUser' | 'CreatedAt'
- `sortDirection` 'ASC' | 'DESC'
- `query` string
- `viewMode` string
- `folderId` string
- `pageNumber` integer
- `pageSize` integer
- `filterType` string[]
- `createdByUserId` string[]
- `userIdsHaveAccessTo` string[]
- `buyerListId` string[]

## Response `200`

Paginated list of bridges

- object
  - `pageNumber` integer, required
  - `pageSize` integer, required
  - `totalItems` integer, required
  - `totalPages` integer, required
  - `result` BridgeResponse[], required
    - `bridgeId` string, uuid, required — Unique identifier for the bridge
    - `name` string, required — Name of the bridge
    - `userId` string, required — User ID who created and owns the bridge
    - `filterType` 'RFP' | 'Meeting' | 'Purchase' | 'Buyer' | 'TopBuyer' | 'Contact' | 'Signal' | 'Conference' | 'JobChange' | 'SequenceBuyer' | 'SequenceContact' | 'SequenceJobChange' | 'VendorPresence' | 'ProductCompetitorPresence' | 'CompanionPresence', required — Type of filter applied to the bridge
    - `status` 'Initializing' | 'Matching' | 'Draft' | 'Open' | 'Failed' | 'Deleting', required — Current status of the bridge
    - `updatedAt` string, required — Timestamp when a user last edited this bridge's configuration (name, columns, sharing). Does NOT indicate when new rows were added
    - `rowCount` integer — Total number of rows in the bridge

## Other responses

- `400` — Invalid request body or format
- `401` — Missing or invalid authentication
- `403` — Unauthorized to access resource or perform action
- `404` — Resource not found
- `415` — Unsupported media type or request body format
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/starbridge/apis/starbridge-external-public-api.md) · [All operations](https://skmtc.dev/starbridge/apis/starbridge-external-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/starbridge/starbridge-external-public-api/revisions/dc7faf636b78/schema)