---
title: "Get Bridge"
method: GET
path: "/api/external/bridge/{bridgeId}"
tags: ["Bridges", "External MCP", "External API"]
---

# Get Bridge

`GET /api/external/bridge/{bridgeId}`

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

## Path parameters

- `bridgeId` string, required

## Response `200`

Bridge details

- BridgeResponse
  - `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)