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

# List Deliveries

> Retrieve delivery history for a specific briefing.

Retrieve the delivery history for a specific briefing schedule.

Results are paginated and sorted by most recent first. Each delivery includes its status, email title, and timestamps. To get the full briefing content, use the [Get Delivery Detail](/api-reference/briefing/delivery-detail) endpoint.

## Pagination

| Parameter  | Default | Max | Description    |
| ---------- | ------- | --- | -------------- |
| `page`     | 1       | —   | Page number    |
| `per_page` | 10      | 50  | Items per page |

## Delivery Status

| Status     | Description                                           |
| ---------- | ----------------------------------------------------- |
| `pending`  | Scheduled but not yet generated                       |
| `sent`     | Successfully generated and delivered                  |
| `failed`   | Generation or delivery failed                         |
| `resynced` | Re-delivered after a content resync                   |
| `skipped`  | Intentional non-send (e.g. no content for this cycle) |


## OpenAPI

````yaml GET /v1/briefings/{id}/deliveries
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/{id}/deliveries:
    get:
      tags:
        - Briefing
      summary: List Deliveries
      description: Retrieve delivery history for a specific briefing.
      operationId: listBriefingDeliveries
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
        - name: page
          in: query
          schema:
            type: integer
            default: 1
        - name: per_page
          in: query
          schema:
            type: integer
            default: 10
            maximum: 50
      responses:
        '200':
          description: Paginated delivery list
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    nullable: true
                  payload:
                    type: object
                    properties:
                      deliveries:
                        type: array
                        items:
                          $ref: '#/components/schemas/BriefingDelivery'
                      total_count:
                        type: integer
                      current_page:
                        type: integer
                      total_pages:
                        type: integer
components:
  schemas:
    BriefingDelivery:
      type: object
      properties:
        id:
          type: string
        status:
          type: string
          enum:
            - pending
            - sent
            - failed
            - resynced
            - skipped
          description: Delivery status
        delivered_at:
          type: string
          nullable: true
        scheduled_at:
          type: string
          nullable: true
        email_title:
          type: string
          nullable: true
        tickers:
          type: array
          items:
            type: string
        frequency:
          type: string
          nullable: true
        created_at:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````