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.

GET /api/external/bridge/{bridgeId}

Get Bridge

cURL

curl --request GET \
  --url https://dashboard.starbridge.ai/api/external/bridge/{bridgeId} \
  --header 'Authorization: Bearer <token>'

200

{
  "bridgeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "userId": "<string>",
  "updatedAt": "<string>",
  "rowCount": 123
}

Authorizations

Authorization · string · header · required

HTTP Bearer Authentication

Path Parameters

bridgeId · string · required

Response

200

application/json

Bridge details

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 · enum<string> · required

Type of filter applied to the bridge

Available options: RFP, Meeting, Purchase, Buyer, Contact, Signal, Conference, JobChange, SequenceBuyer, SequenceContact, SequenceJobChange

status · enum<string> · required

Current status of the bridge

Available options: Initializing, Matching, Draft, Open, Failed, Deleting

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