> ## Documentation Index
> Fetch the complete documentation index at: https://hc.starbridge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Buyer Summary

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



## OpenAPI

````yaml https://core-http2-157602306522.us-central1.run.app/external/public/swagger/documentation.yaml get /api/external/buyer/{buyerId}/summary
openapi: 3.1.1
info:
  title: Starbridge External Public API
  version: '1.0'
servers:
  - url: https://dashboard.starbridge.ai
security: []
paths:
  /api/external/buyer/{buyerId}/summary:
    get:
      tags:
        - Buyer
        - External MCP
        - External API
      summary: Get Buyer Summary
      description: >-
        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.
      operationId: getBuyerSummary
      parameters:
        - name: buyerId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Buyer activity summary grounded in tracked account activity.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BuyerSummaryResponse'
        '400':
          description: Invalid request body or format
        '401':
          description: Missing or invalid authentication
        '403':
          description: Unauthorized to access resource or perform action
        '404':
          description: Resource not found
        '415':
          description: Unsupported media type or request body format
        '429':
          description: Rate limit exceeded
        '500':
          description: Internal server error
      security:
        - apiKey: []
components:
  schemas:
    BuyerSummaryResponse:
      type: object
      title: BuyerSummaryResponse
      required:
        - buyerId
        - needsRegeneration
      properties:
        buyerId:
          type: string
          format: uuid
        summary:
          oneOf:
            - $ref: '#/components/schemas/BuyerSummaryContent'
            - type: 'null'
        score:
          type:
            - integer
            - 'null'
        scoreReasoning:
          type:
            - string
            - 'null'
        generatedAt:
          type:
            - string
            - 'null'
        needsRegeneration:
          type: boolean
    BuyerSummaryContent:
      type: object
      title: BuyerSummaryContent
      required:
        - whatsRecent
        - theBiggerPicture
        - areasForDeeperDiscovery
      properties:
        whatsRecent:
          $ref: '#/components/schemas/DetailSection'
        theBiggerPicture:
          $ref: '#/components/schemas/DetailSection'
        areasForDeeperDiscovery:
          $ref: '#/components/schemas/DetailSection'
    DetailSection:
      type: object
      title: DetailSection
      required:
        - sections
      properties:
        status:
          type: string
          enum:
            - Standard
            - Fallback
        intro:
          type: string
        sections:
          type: array
          items:
            $ref: '#/components/schemas/Section'
    Section:
      type: object
      title: Section
      required:
        - title
        - text
      properties:
        title:
          type: string
        text:
          type: string
        sources:
          type: array
          items:
            $ref: '#/components/schemas/EntrySource'
    EntrySource:
      type: object
      title: EntrySource
      required:
        - entryId
        - triggerId
      properties:
        entryId:
          type: string
          format: uuid
        triggerId:
          type: string
          format: uuid
        triggerType:
          type:
            - string
            - 'null'
        triggerName:
          type:
            - string
            - 'null'
        entryName:
          type:
            - string
            - 'null'
  securitySchemes:
    apiKey:
      scheme: bearer
      description: HTTP Bearer Authentication
      type: http

````