REST API

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.

Note on consistency: the data backing search/sort/filter is maintained separately from the row values returned here, and the two can briefly drift apart — especially while the service is under heavy load. As a result, recent changes (new rows, status changes, updated column values, updatedAt, etc.) may not be reflected in listing, sorting, or filtering immediately; they usually become consistent within a short time. If a just-changed row does not appear where you expect, retry shortly.

PUT

api

external

bridge

{bridgeId}

row

List Bridge Rows

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

import requests

url = "https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"

response = http.request(request)
puts response.read_body

{
  "pageNumber": 123,
  "pageSize": 123,
  "totalItems": 123,
  "totalPages": 123,
  "result": [
    {
      "rowId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "bridgeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "createdAt": "<string>",
      "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 | null

    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. The synthetic column `rowUpdatedAt` sorts by when
    the row was last updated — sort `DESC` to poll for recently-changed rows, matching the
    `updatedAt` field in the response. Sort columns that are not mapped on the server return 400.

Show child attributes

query

string | null

Full-text search query

Response

Paginated list of bridge rows

pageNumber

integer

required

pageSize

integer

required

totalItems

integer

required

totalPages

integer

required

result

BridgeRowResponse · object[]

required

Show child attributes

Set Bridge Row StatusSet the user-facing status for a single row in a Bridge. The `rowId` must identify a row that belongs to the specified `bridgeId`. Use this when a caller needs to move one Bridge row to a new status without updating any other column values. Supported default values are `New`, `Actioned`, `Saved`, `Not Interested`. For conferences it might additionally include `Attending`, `Sponsoring`. In the UI, 'New' is shown as 'Needs action', and 'Saved' is shown as 'Starred'. Filtering on Actioned will include Sponsoring and Attending.

⌘I

List Bridge Rows

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

import requests

url = "https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"

response = http.request(request)
puts response.read_body

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