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 '
{
  "filters": {
    "terms": [
      {
        "field": "<string>",
        "value": "<unknown>"
      }
    ]
  },
  "sorts": [
    {
      "column": "<string>"
    }
  ],
  "query": "<string>",
  "buyerScope": {
    "buyerListId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "terms": [
      {
        "value": "<unknown>"
      }
    ]
  },
  "columnIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "archived": true,
  "includeBasis": true
}
'

import requests

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

payload = {
    "filters": { "terms": [
            {
                "field": "<string>",
                "value": "<unknown>"
            }
        ] },
    "sorts": [{ "column": "<string>" }],
    "query": "<string>",
    "buyerScope": {
        "buyerListId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "terms": [{ "value": "<unknown>" }]
    },
    "columnIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "archived": True,
    "includeBasis": True
}
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({
    filters: {terms: [{field: '<string>', value: '<unknown>'}]},
    sorts: [{column: '<string>'}],
    query: '<string>',
    buyerScope: {
      buyerListId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
      terms: [{value: '<unknown>'}]
    },
    columnIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    archived: true,
    includeBasis: true
  })
};

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([
    'filters' => [
        'terms' => [
                [
                                'field' => '<string>',
                                'value' => '<unknown>'
                ]
        ]
    ],
    'sorts' => [
        [
                'column' => '<string>'
        ]
    ],
    'query' => '<string>',
    'buyerScope' => [
        'buyerListId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        'terms' => [
                [
                                'value' => '<unknown>'
                ]
        ]
    ],
    'columnIds' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'archived' => true,
    'includeBasis' => true
  ]),
  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("{\n  \"filters\": {\n    \"terms\": [\n      {\n        \"field\": \"<string>\",\n        \"value\": \"<unknown>\"\n      }\n    ]\n  },\n  \"sorts\": [\n    {\n      \"column\": \"<string>\"\n    }\n  ],\n  \"query\": \"<string>\",\n  \"buyerScope\": {\n    \"buyerListId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n    \"terms\": [\n      {\n        \"value\": \"<unknown>\"\n      }\n    ]\n  },\n  \"columnIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"archived\": true,\n  \"includeBasis\": true\n}")

	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("{\n  \"filters\": {\n    \"terms\": [\n      {\n        \"field\": \"<string>\",\n        \"value\": \"<unknown>\"\n      }\n    ]\n  },\n  \"sorts\": [\n    {\n      \"column\": \"<string>\"\n    }\n  ],\n  \"query\": \"<string>\",\n  \"buyerScope\": {\n    \"buyerListId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n    \"terms\": [\n      {\n        \"value\": \"<unknown>\"\n      }\n    ]\n  },\n  \"columnIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"archived\": true,\n  \"includeBasis\": true\n}")
  .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 = "{\n  \"filters\": {\n    \"terms\": [\n      {\n        \"field\": \"<string>\",\n        \"value\": \"<unknown>\"\n      }\n    ]\n  },\n  \"sorts\": [\n    {\n      \"column\": \"<string>\"\n    }\n  ],\n  \"query\": \"<string>\",\n  \"buyerScope\": {\n    \"buyerListId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n    \"terms\": [\n      {\n        \"value\": \"<unknown>\"\n      }\n    ]\n  },\n  \"columnIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"archived\": true,\n  \"includeBasis\": true\n}"

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": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "status": "NotProcessed",
      "columns": {},
      "url": "<string>",
      "name": "<string>",
      "buyerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "organizerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "entity": {
        "type": "RFP",
        "id": "<string>"
      },
      "archive": {
        "archived": true,
        "archivedAt": "2023-11-07T05:31:56Z",
        "archivedBy": "<string>",
        "source": "User",
        "restoredAt": "2023-11-07T05:31:56Z",
        "restoredBy": "<string>"
      }
    }
  ]
}

REST API

List Bridge Rows

List a bridge's rows — the matches it has produced — with server-side filtering, sorting, full-text search, buyer scoping and column projection. Each row carries its processing status, the buyer or organizer it belongs to, timestamps, and its per-column values keyed by the column's display name. `includeBasis` adds the reasoning, confidence and sources behind each cell's value. Call `getBridgeFull` first: `filters[].field` and `sorts[].column` take a column's `columnId` UUID, never its name. A few row-level fields (`status`, `buyerId`, `opportunityId`, `entryName`, `triggeredAt`, `entryId`, and `rowUpdatedAt` for sorting) are also accepted. `entryId` equals a row's `rowId`: to read one row, set `filters` to {"terms":[{"field":"entryId","operation":"Equals","value":"<rowId>"}]} instead of paging. Always narrow server-side with `filters`, `query` and `buyerScope` rather than paging through everything, and set `columnIds` to just the columns you need — a wide bridge's rows are the fastest way to fill a context window. Omit `sorts` to list the newest rows first. `buyerScope` narrows to rows whose buyer matches a saved buyer list (`buyerListId`) or inline `terms`, on top of `filters`. For how many cells of each column sit in each processing status — whether a `processBridgeRows` run has finished — call `getBridgeRowStats` instead of paging. Paging: start at `pageNumber=1` and increment while `pageNumber < totalPages`; a page with no items is the end. `pageSize` defaults to 10 and may not exceed 100. Consistency: the index behind search, sort and filter is maintained separately from the row values, so a change made moments ago — a new row, a status, a fresh cell — may not show yet; retry shortly if a just-changed row is not where you expect it. For the history behind one CRM-sync or buyer-match cell, call `getBridgeCellHistory`.

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 '
{
  "filters": {
    "terms": [
      {
        "field": "<string>",
        "value": "<unknown>"
      }
    ]
  },
  "sorts": [
    {
      "column": "<string>"
    }
  ],
  "query": "<string>",
  "buyerScope": {
    "buyerListId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "terms": [
      {
        "value": "<unknown>"
      }
    ]
  },
  "columnIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "archived": true,
  "includeBasis": true
}
'

import requests

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

payload = {
    "filters": { "terms": [
            {
                "field": "<string>",
                "value": "<unknown>"
            }
        ] },
    "sorts": [{ "column": "<string>" }],
    "query": "<string>",
    "buyerScope": {
        "buyerListId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "terms": [{ "value": "<unknown>" }]
    },
    "columnIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "archived": True,
    "includeBasis": True
}
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({
    filters: {terms: [{field: '<string>', value: '<unknown>'}]},
    sorts: [{column: '<string>'}],
    query: '<string>',
    buyerScope: {
      buyerListId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
      terms: [{value: '<unknown>'}]
    },
    columnIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    archived: true,
    includeBasis: true
  })
};

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([
    'filters' => [
        'terms' => [
                [
                                'field' => '<string>',
                                'value' => '<unknown>'
                ]
        ]
    ],
    'sorts' => [
        [
                'column' => '<string>'
        ]
    ],
    'query' => '<string>',
    'buyerScope' => [
        'buyerListId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        'terms' => [
                [
                                'value' => '<unknown>'
                ]
        ]
    ],
    'columnIds' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'archived' => true,
    'includeBasis' => true
  ]),
  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("{\n  \"filters\": {\n    \"terms\": [\n      {\n        \"field\": \"<string>\",\n        \"value\": \"<unknown>\"\n      }\n    ]\n  },\n  \"sorts\": [\n    {\n      \"column\": \"<string>\"\n    }\n  ],\n  \"query\": \"<string>\",\n  \"buyerScope\": {\n    \"buyerListId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n    \"terms\": [\n      {\n        \"value\": \"<unknown>\"\n      }\n    ]\n  },\n  \"columnIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"archived\": true,\n  \"includeBasis\": true\n}")

	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("{\n  \"filters\": {\n    \"terms\": [\n      {\n        \"field\": \"<string>\",\n        \"value\": \"<unknown>\"\n      }\n    ]\n  },\n  \"sorts\": [\n    {\n      \"column\": \"<string>\"\n    }\n  ],\n  \"query\": \"<string>\",\n  \"buyerScope\": {\n    \"buyerListId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n    \"terms\": [\n      {\n        \"value\": \"<unknown>\"\n      }\n    ]\n  },\n  \"columnIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"archived\": true,\n  \"includeBasis\": true\n}")
  .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 = "{\n  \"filters\": {\n    \"terms\": [\n      {\n        \"field\": \"<string>\",\n        \"value\": \"<unknown>\"\n      }\n    ]\n  },\n  \"sorts\": [\n    {\n      \"column\": \"<string>\"\n    }\n  ],\n  \"query\": \"<string>\",\n  \"buyerScope\": {\n    \"buyerListId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n    \"terms\": [\n      {\n        \"value\": \"<unknown>\"\n      }\n    ]\n  },\n  \"columnIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"archived\": true,\n  \"includeBasis\": true\n}"

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": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "status": "NotProcessed",
      "columns": {},
      "url": "<string>",
      "name": "<string>",
      "buyerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "organizerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "entity": {
        "type": "RFP",
        "id": "<string>"
      },
      "archive": {
        "archived": true,
        "archivedAt": "2023-11-07T05:31:56Z",
        "archivedBy": "<string>",
        "source": "User",
        "restoredAt": "2023-11-07T05:31:56Z",
        "restoredBy": "<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, buyer scoping and column projection. An empty body lists the bridge's rows unfiltered.

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. Fields computed per row when the Bridge is read —
    `op:added_date` ("Added to Bridge") and `bridge:entry_url` — are never sortable and
    return 400; sort by `triggeredAt` instead. 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.
 Omit `sorts` for the bridge's default order, the order `runRows: FirstFiveRows` takes its five rows from. A sort on an object column is refused: sort a Top Buyers bridge by its Account Scoring Score column, not the Account Score object. An enumeration column such as Fit Band sorts alphabetically, so filter it with `Any` instead. A `processBridgeRows` `limit` takes its rows from the same default order.

Show child attributes

query

string | null

Full-text search across the rows' searchable content

buyerScope

BridgeBuyerScopeConfiguration · object | null

Narrows the rows to those whose buyer matches this scope, on top of filters. Either a saved buyer list (buyerListId) or inline terms — never both. Use listBuyerLists to find a list id.

Show child attributes

columnIds

string<uuid>[] | null

Project each row's columns down to these column ids. Every id must belong to this bridge. Omit to get every column getBridgeFull lists, including the ones hidden from the table view — send it whenever you only need a few, it is the cheapest way to keep a wide bridge inside a context window, and a link column left out is not resolved at all.

archived

boolean

True to list the bridge's archived rows instead of its live ones, most recently archived first unless sorts is sent — rowArchivedAt sorts by archive date; filters, query, buyerScope and columnIds apply the same way

includeBasis

boolean

Whether to add each cell's basis: the reasoning, confidence and cited sources behind its value, for explaining why a row holds what it does. Only columns that research the web, such as web agent columns, record one. A basis can run to thousands of characters, so send it with columnIds set to just the columns you are explaining and a pageSize of 5 or fewer. Each cell lists at most its first 10 citations, each with at most 3 excerpts cut to 500 characters. Defaults to false.

Response

Paginated rows

pageNumber

integer

required

1-based page number this page answers

pageSize

integer

required

Rows per page

totalItems

integer

required

Rows matching the request across every page

totalPages

integer

required

Number of pages; page while pageNumber < totalPages, and a page with no items is the end

result

BridgeRowResponse · object[]

required

The rows of this page, with their per-column values keyed by column name

Show child attributes

⌘I