---
title: "Get Buyer Summary"
method: GET
path: "/api/external/buyer/{buyerId}/summary"
tags: ["Buyer", "External MCP", "External API"]
---

# Get Buyer Summary

`GET /api/external/buyer/{buyerId}/summary`

## Request

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

Retrieve a buyer activity summary synthesized from tracked buyer activity and available signals. Use this for buyer strategy, top priorities, momentum, risks, opportunity framing, account context across the available information, and outreach preparation. Generates on-demand if the cached summary is missing or stale. The `summary` field is structured into three sections (`whatsRecent`, `theBiggerPicture`, `areasForDeeperDiscovery`); each section's `sources` carry `triggerId`/`entryId` back-pointers so you can drill into a citation via `listBridgeRows`. The `summary` can be `null` while a (re)generation is in flight, in which case `needsRegeneration` is true. Returns 404 (`resource.buyer.summary.empty`) when no Bridges in the org are configured to track this buyer — there is nothing to summarize, so suggest the user set up a Bridge that covers this buyer rather than retrying.

## Path parameters

- `buyerId` string, required

## Response `200`

Buyer activity summary grounded in tracked account activity.

- BuyerSummaryResponse
  - `buyerId` string, uuid, required
  - `summary` BuyerSummaryContent
    - `whatsRecent` DetailSection, required
      - `status` 'Standard' | 'Fallback'
      - `intro` string
      - `sections` Section[], required
        - `title` string, required
        - `text` string, required
        - `sources` EntrySource[]
          - `entryId` string, uuid, required
          - `triggerId` string, uuid, required
          - `triggerType` string, nullable
          - `triggerName` string, nullable
          - `entryName` string, nullable
    - `theBiggerPicture` DetailSection, required
      - `status` 'Standard' | 'Fallback'
      - `intro` string
      - `sections` Section[], required
        - `title` string, required
        - `text` string, required
        - `sources` EntrySource[]
          - `entryId` string, uuid, required
          - `triggerId` string, uuid, required
          - `triggerType` string, nullable
          - `triggerName` string, nullable
          - `entryName` string, nullable
    - `areasForDeeperDiscovery` DetailSection, required
      - `status` 'Standard' | 'Fallback'
      - `intro` string
      - `sections` Section[], required
        - `title` string, required
        - `text` string, required
        - `sources` EntrySource[]
          - `entryId` string, uuid, required
          - `triggerId` string, uuid, required
          - `triggerType` string, nullable
          - `triggerName` string, nullable
          - `entryName` string, nullable
  - `score` integer, nullable
  - `scoreReasoning` string, nullable
  - `generatedAt` string, nullable
  - `needsRegeneration` boolean, 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)