---
title: "List Recent Buyer Signals"
method: GET
path: "/api/external/feed/all/buyer-signals"
tags: ["Signal", "External MCP", "External API"]
---

# List Recent Buyer Signals

`GET /api/external/feed/all/buyer-signals`

Returns the most recent Starbridge signals (bridge rows) for a given buyer within the organization. A signal pairs a bridge (the monitoring definition) with a row (a concrete match). Supports filtering by bridge ids, bridge filter types, row statuses, and a relative date period. Default sort is by signal date (most recent first); pass sort=Hotness to rank by hotness score. All sorts are descending.

## Query parameters

- `triggerIds` string[]
- `sort` 'Date' | 'Hotness'
- `pageNumber` integer
- `pageSize` integer
- `buyerId` string, uuid, required
- `filterType` string[]
- `status` string[]
- `relativeDatePeriodFrom` 'LastOneDay' | 'LastSevenDays' | 'LastThirtyDays' | 'LastSixtyDays' | 'LastOneMonths' | 'LastTwoMonths' | 'LastThreeMonths' | 'LastSixMonths' | 'LastNineMonths' | 'LastYear' | 'LastTwoYears'

## Response `200`

Paginated list of recent signals for the buyer.

- object
  - `pageNumber` integer, required
  - `pageSize` integer, required
  - `totalItems` integer, required
  - `totalPages` integer, required
  - `result` BridgeSignalResponse[], required
    - `bridge` BridgeBrief, required
      - `bridgeId` string, uuid, required — Unique identifier for the bridge
      - `name` string, required — Name of the bridge
      - `filterType` 'RFP' | 'Meeting' | 'Purchase' | 'Buyer' | 'TopBuyer' | 'Contact' | 'Signal' | 'Conference' | 'JobChange' | 'SequenceBuyer' | 'SequenceContact' | 'SequenceJobChange' | 'VendorPresence' | 'ProductCompetitorPresence' | 'CompanionPresence', required — Type of filter applied to the bridge
      - `columns` BridgeColumnResponse[], required
        - `columnId` string, uuid, required — Unique identifier for the column
        - `bridgeId` string, uuid, required — UUID of the bridge this column belongs to
        - `name` string, required — Display name of the column
        - `prompt` string, required — Prompt or instruction for generating column values
        - `type` 'AiAnalysis' | 'DataAttribute' | 'AiAnalysisTemplate' | 'WebAgentTemplate' | 'Input' | 'Link' | 'CrmLookup' | 'CrmSync' | 'LinkToCell' | 'CompetitorsPresence' | 'EmailTemplate' | 'PhoneCallTemplate' | 'Webhook' | 'MultiLink' | 'AccountScoring', required — Type of column (AiAnalysis, DataAttribute, AiAnalysisTemplate, etc.)
        - `fieldFormat` BridgeFieldFormat, required — Field format specification for the column
          - `baseFormat` 'text' | 'date' | 'url' | 'number' | 'enumeration' | 'list' | 'obj' | 'json' | 'phone' | 'email' | 'boolean' | 'currencyUnit', required — Base data type of the field (String, Integer, Boolean, etc.)
          - `description` string, nullable — Optional description of the field
          - `enumerationValues` FieldFormatEnumerationValue[], nullable — Optional list of enumeration values if field is a select type
            - `value` string, required
            - `label` string
          - `currency` 'USD' | 'CAD', nullable — Optional currency type if field represents a monetary value
          - `listElementBaseFormat` 'text' | 'date' | 'url' | 'number' | 'enumeration' | 'list' | 'obj' | 'json' | 'phone' | 'email' | 'boolean' | 'currencyUnit', nullable — Base format type for list elements if field is a list type
          - `outputFields` BridgeObjFieldDefinition[], nullable — Optional field definitions for object type fields
            - `name` string, required — Name of the field
            - `type` 'text' | 'date' | 'url' | 'number' | 'enumeration' | 'list' | 'obj' | 'json' | 'phone' | 'email' | 'boolean' | 'currencyUnit', required — Data type of the field
            - `description` string, nullable — Optional description of the field
        - `index` integer, required — Zero-based index position of the column
        - `key` string, nullable — Optional key for referencing the column
    - `row` BridgeRowResponse, required
      - `rowId` string, uuid, required — Unique identifier for the row
      - `name` string, nullable — Optional name or title of the row
      - `bridgeId` string, uuid, required — UUID of the bridge this row belongs to
      - `createdAt` string, required — Timestamp when the row was created (added to the bridge).
      - `updatedAt` string, required — Timestamp when the row was last updated. This is a technical last-updated field: in addition to meaningful changes (status, column values), non-meaningful changes such as a bulk re-sync or maintenance can also advance it. Sort by `rowUpdatedAt` to page through recently-changed rows.
      - `status` 'NotProcessed' | 'Queued' | 'Processing' | 'Processed' | 'Failed' | 'Skipped', required — Current processing status of the row
      - `buyerId` string, uuid, nullable — UUID of the buyer associated with this row, if any
      - `organizerId` string, uuid, nullable — UUID of the conference organizer associated with this row, if any
      - `entity` BridgeRowEntityRef — Reference to the underlying entity (id + type) this row represents, when available.
        - `type` 'RFP' | 'Meeting' | 'Purchase' | 'Buyer' | 'TopBuyer' | 'Contact' | 'Signal' | 'Conference' | 'JobChange' | 'SequenceBuyer' | 'SequenceContact' | 'SequenceJobChange' | 'VendorPresence' | 'ProductCompetitorPresence' | 'CompanionPresence', required — Kind of entity `id` refers to (e.g. Conference, Buyer, Opportunity).
        - `id` string, required — Identifier of the underlying entity. Pass to entity-specific tools (e.g. opportunity line items, file downloads) to fetch detail beyond the bridge's columns.
      - `columns` object, required

## Other responses

- `400` — Invalid request body or format
- `401` — Missing or invalid authentication
- `403` — Unauthorized to access resource or perform action
- `404` — Resource not found
- `415` — Unsupported media type or request body format
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/starbridge/apis/starbridge-external-public-api.md) · [All operations](https://skmtc.net/starbridge/apis/starbridge-external-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/starbridge/starbridge-external-public-api/revisions/dc7faf636b78/schema)