---
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`

## Request

- Base URL: `https://dashboard.starbridge.ai`
- URL: `https://dashboard.starbridge.ai/api/external/feed/all/buyer-signals`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/starbridge/apis/starbridge-external-public-api/docs/api/external/feed/all/buyer-signals/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/starbridge/apis/starbridge-external-public-api.md) - [All operations](https://skmtc.dev/starbridge/apis/starbridge-external-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starbridge/apis/starbridge-external-public-api/revisions/dc7faf636b78?raw)