List Bridge Rows

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

For any column-targeted filter or sort — including Match Score, Match reasoning, and any user-defined column — first call getBridgeColumnMetadata to obtain that column’s columnId UUID and pass it as BridgeFilters.terms[].field or RowSort.column. The column’s display name, key, or any prefixed reference is NOT a valid value. A small set of common entry-level fields (status, buyerId, opportunityId, entryName, triggeredAt) is also accepted for filtering. Sort or filter columns that are not mapped on the server return 400. 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.

PUT /api/external/bridge/{bridgeId}/row

List Bridge Rows

cURL

curl --request PUT \
  --url https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

200

{
  "pageNumber": 123,
  "pageSize": 123,
  "totalItems": 123,
  "totalPages": 123,
  "result": [
    {
      "rowId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "bridgeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "updatedAt": "<string>",
      "columns": {},
      "name": "<string>",
      "buyerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "organizerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "entity": {
        "id": "<string>"
      }
    }
  ]
}

Authorizations

Authorization · string · header · required

HTTP Bearer Authentication

Path Parameters

bridgeId · string · required

Query Parameters

pageNumber · integer · default: 1

Page number, 1-based. Minimum 1.

pageSize · integer · default: 10

Page size. Must be > 0 and <= 100. Prefer <= 20.

Body

application/json

Filtering, sorting, and free-text search parameters for bridge rows. Refer to examples for proper usage.

filters · BridgeFilters · object

Filter criteria for bridge rows. All `terms` are combined with logical AND — a row must
    satisfy every term to be included. Provide an empty `terms` list (or omit `filters`) to
    return all rows.

Show child attributes

sorts · RowSort · object[] | null

Sort specification for rows. For each sort term, `column` should be a bridge
    column's `columnId` UUID — call `getBridgeColumnMetadata` to look it up. The
    column's display name, `key`, or any prefixed reference is not a valid value.
    A small set of common entry-level fields (`entryId`, `entryName`, `triggeredAt`)
    is also accepted but discouraged. Sort columns that are not mapped on the server return 400.

Show child attributes

query · string | null

Full-text search query

Response

200

application/json

Paginated list of bridge rows

pageNumber · integer · required

pageSize · integer · required

totalItems · integer · required

totalPages · integer · required

result · BridgeRowResponse · object[] · required

Show child attributes