REST API

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

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

Authorizations

Authorization

string

header

required

HTTP Bearer Authentication

Path Parameters

bridgeId

string

required

Response

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

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

List Bridge RowsList the rows of a single Bridge — the concrete matches the Bridge has produced — with optional filtering, sorting, and full-text search. Each row carries a processing status, optional buyer/organizer association, an `updatedAt` timestamp, and the per-column values populated for that match. The per-row `columns` map is keyed by the human-readable column name (not by columnId), and values are polymorphic per the column's `fieldFormat` (string / number / boolean / object / null). Prefer narrowing server-side with `filters`, `sorts`, and `query` in the request body over scanning every page. To filter on a specific column, first call `getBridgeColumnMetadata` to obtain the column's `columnId` UUID and reference it from `BridgeFilters.terms[].field`; common entry-level fields (`status`, `buyerId`, `opportunityId`, `entryName`, `triggeredAt`, `confidenceScore`, etc.) are also filterable. See `ListBridgeRowsRequest` for the full schema of supported filter terms, operations, and sort columns. To paginate, start at `pageNumber=1` and increment until `pageNumber == totalPages`.

⌘I

Get Bridge

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

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

REST API

Webhooks

Documentation Index

Authorizations

Path Parameters

Response