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

# Get Delivery References

> Retrieves the full list of citation references (sources) used to generate a briefing delivery.

Briefing email content includes inline citations `[N]` that point into this list via `citation_idx`. Use this endpoint to build custom UIs, export source lists, or link readers back to original documents.

**Usage Flow:**
1. Get a delivery via [List Deliveries](/api-reference/briefing/deliveries) or [Get Delivery Detail](/api-reference/briefing/delivery-detail) — note the `chat_session_id`
2. Verify delivery status is `sent`
3. Call this endpoint with `delivery_id`
4. For each reference, dispatch on `search_type` to build the viewer URL (see below)

**How to view original documents** (switch on `search_type`):
- `external` / `news` — the reference already links to the source. Use `external_url` directly (Factset viewer URL for news, publisher URL for external).
- `tfs` (transcripts & filings) — open in the LinqAlpha document viewer: `https://chat.linqalpha.com/documents/{document_id}`. To download the raw file, pass `document_id` to the [Presigned URL](/api-reference/basic/presigned_url) endpoint.
- `rms` (internal research, RMS-connected organizations) — open in the RMS viewer: `https://chat.linqalpha.com/rms/viewer?conversation_id={chat_session_id}&citation_idx={citation_idx}`. `chat_session_id` comes from the delivery detail response.

**Error codes** (returned in response body with HTTP 200):
- `BRIEFING_DELIVERY_NOT_FOUND` — `delivery_id` does not exist or does not belong to your organization
- `BRIEFING_DELIVERY_REFERENCES_NOT_AVAILABLE` — delivery exists but has no associated session (still pending or generation failed)
- `GET_SESSION_REFERENCES_FAIL` — upstream fetch failed

Retrieves the citation references (sources) used to generate a briefing delivery. Briefing email content embeds inline citations `[N]` that point into this list via `citation_idx`.

References become available once the delivery status is `sent`. Call [Get Delivery Detail](/api-reference/briefing/delivery-detail) first to confirm status and to grab the `chat_session_id` (required for building RMS viewer URLs).


## OpenAPI

````yaml GET /v1/briefings/deliveries/{delivery_id}/references
openapi: 3.0.1
info:
  title: LinqAlpha API
  description: >-
    Linq helps finance professionals make informed decisions using
    Retrieval-Augmented Generation (RAG)-enhanced answers. By leveraging
    cutting-edge Large Language Models (LLM) and supplementary technology, Linq
    provides the most optimized responses based on your queries.
  version: 1.0.0
  license:
    name: MIT
servers:
  - url: https://api.linqalpha.com
security:
  - ApiKeyAuth: []
tags:
  - name: Search
    description: Search and generate responses
  - name: Data
    description: Data retrieval and mapping
  - name: Feedback
    description: Conversation feedback
  - name: RMS
    description: Research Management System
  - name: Source Management
    description: Source batch and file management
  - name: MCP
    description: >-
      LinqAlpha MCP — Financial data tools for AI assistants via Model Context
      Protocol
  - name: Connectors
    description: Customer Connectors — customer-owned MCP connector management
  - name: Briefing
    description: Briefing Agent — automated market briefings with scheduling and delivery
  - name: Status
    description: Sync status — check organization, document, and container sync progress
paths:
  /v1/briefings/deliveries/{delivery_id}/references:
    get:
      tags:
        - Briefing
      summary: Get Delivery References
      description: >-
        Retrieves the full list of citation references (sources) used to
        generate a briefing delivery.


        Briefing email content includes inline citations `[N]` that point into
        this list via `citation_idx`. Use this endpoint to build custom UIs,
        export source lists, or link readers back to original documents.


        **Usage Flow:**

        1. Get a delivery via [List
        Deliveries](/api-reference/briefing/deliveries) or [Get Delivery
        Detail](/api-reference/briefing/delivery-detail) — note the
        `chat_session_id`

        2. Verify delivery status is `sent`

        3. Call this endpoint with `delivery_id`

        4. For each reference, dispatch on `search_type` to build the viewer URL
        (see below)


        **How to view original documents** (switch on `search_type`):

        - `external` / `news` — the reference already links to the source. Use
        `external_url` directly (Factset viewer URL for news, publisher URL for
        external).

        - `tfs` (transcripts & filings) — open in the LinqAlpha document viewer:
        `https://chat.linqalpha.com/documents/{document_id}`. To download the
        raw file, pass `document_id` to the [Presigned
        URL](/api-reference/basic/presigned_url) endpoint.

        - `rms` (internal research, RMS-connected organizations) — open in the
        RMS viewer:
        `https://chat.linqalpha.com/rms/viewer?conversation_id={chat_session_id}&citation_idx={citation_idx}`.
        `chat_session_id` comes from the delivery detail response.


        **Error codes** (returned in response body with HTTP 200):

        - `BRIEFING_DELIVERY_NOT_FOUND` — `delivery_id` does not exist or does
        not belong to your organization

        - `BRIEFING_DELIVERY_REFERENCES_NOT_AVAILABLE` — delivery exists but has
        no associated session (still pending or generation failed)

        - `GET_SESSION_REFERENCES_FAIL` — upstream fetch failed
      operationId: getBriefingDeliveryReferences
      parameters:
        - name: delivery_id
          in: path
          description: Delivery ID (UUID).
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: References used in the briefing delivery.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReferencesV2Response'
              example:
                error: null
                payload:
                  references:
                    - id: cd0a3298-8798-4817-b78f-734d5e0fc095
                      citation_idx: 1
                      search_type: external
                      chunk_id: c063d35f-f143-4813-9d40-8733e5779b06
                      text: >-
                        Stock futures are climbing as President Donald Trump's
                        deadline to reopen the Strait of Hormuz approaches.
                      text_type: news
                      document_id: null
                      document_name: >-
                        Stock Market Today (Apr. 7, 2026): Futures climb ahead
                        of Trump Iran deadline
                      s3_file_key: >-
                        https://www.thestreet.com/latest-news/stock-market-today-apr-7-2026-updates
                      external_url: >-
                        https://www.thestreet.com/latest-news/stock-market-today-apr-7-2026-updates
                      metadata:
                        source: news
                        calendar_date: '2026-04-07'
                    - id: f99d92bc-6d36-4c21-9f2b-2b7d57fa9c79
                      citation_idx: 10
                      search_type: external
                      chunk_id: b78e60cf-e0a2-420a-9da0-e2b5845a7ad0
                      text: >-
                        Franklin Resources Reports Lower March Assets Under
                        Management. Franklin Resources (BEN) late Monday
                        reported preliminary March assets under management of
                        $1.68 trillion, down from $1.73 trillion in February.
                      text_type: news
                      document_id: b78e60cf-e0a2-420a-9da0-e2b5845a7ad0
                      document_name: >-
                        Franklin Resources Reports Lower March Assets Under
                        Management
                      s3_file_key: null
                      external_url: >-
                        https://my.apps.factset.com/viewer-fusion/?_doc_id=A3596626&_doc_date=2026-04-06&_doc_product=MNW
                      metadata:
                        source: news
                        rms_document_type: news
                        calendar_date: '2026-04-06T17:09:34.000Z'
                        document_category: news
                        stock_ids:
                          - BBG001S5P3W6
                        tickers:
                          - BEN
        '400':
          description: Invalid `delivery_id` (not a valid UUID).
components:
  schemas:
    ReferencesV2Response:
      type: object
      properties:
        references:
          type: array
          items:
            $ref: '#/components/schemas/ReferenceV2'
          description: List of references associated with the conversation
      required:
        - references
    ReferenceV2:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Reference ID
        citation_idx:
          type: integer
          description: Citation index number
        search_type:
          type: string
          description: Type of search that produced this reference (e.g., "rms")
        chunk_id:
          type: string
          description: Chunk identifier
        text:
          type: string
          description: Reference text content
        text_type:
          type: string
          description: Type of text (e.g., "paragraph")
        document_id:
          type: string
          format: uuid
          description: Document ID. Use with presigned_url endpoint for direct download.
        document_name:
          type: string
          description: Document name
        s3_file_key:
          type: string
          nullable: true
          description: S3 file key (may be null)
        external_url:
          type: string
          description: External URL for the document
        metadata:
          $ref: '#/components/schemas/ReferenceMetadataV2'
      required:
        - id
        - citation_idx
        - search_type
        - chunk_id
        - text
        - text_type
        - document_id
        - document_name
        - s3_file_key
        - external_url
        - metadata
    ReferenceMetadataV2:
      type: object
      properties:
        rms_type:
          type: string
          nullable: true
        rms_sub_type:
          type: string
          nullable: true
        rms_document_type:
          type: string
          nullable: true
          description: Document type (e.g., "earnings_call", "filing")
        source:
          type: string
          nullable: true
        countries:
          type: array
          items:
            type: string
          nullable: true
        regions:
          type: array
          items:
            type: string
          nullable: true
        participants:
          type: array
          items:
            type: string
          nullable: true
        tags:
          type: array
          items:
            type: string
          nullable: true
        publisher:
          type: string
          nullable: true
        calendar_date:
          type: string
          nullable: true
        fiscal_year:
          type: string
          nullable: true
        fiscal_quarter:
          type: string
          nullable: true
        document_category:
          type: string
          nullable: true
          description: Document category (e.g., "earnings_call")
        document_subcategory:
          type: string
          nullable: true
        sector:
          type: string
          nullable: true
        subsector:
          type: string
          nullable: true
        stock_ids:
          type: array
          items:
            type: string
          nullable: true
          description: Bloomberg Global Identifiers (e.g., ["BBG001S5N8V8"])
        tickers:
          type: array
          items:
            type: string
          nullable: true
          description: Ticker symbols (e.g., ["AAPL"])
        company_names:
          type: array
          items:
            type: string
          nullable: true
        offset:
          type: integer
          nullable: true
        snippet:
          type: string
          nullable: true
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````