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

# List stored delivery days

> List every delivery day the forecast service holds, newest first, with the `input_hash` of its stored submission and whether that exact input was already processed downstream.



## OpenAPI

````yaml /portfolio-forecasts-openapi.json get /portfolio-forecasts/v1alpha1/submissions
openapi: 3.1.0
info:
  title: Engrate Portfolio Forecasts API
  version: v1alpha1
  description: >-
    Submit portfolio forecasts for a delivery day and read back what is stored.
    This alpha API may change or be removed without notice.
servers:
  - url: https://api.engrate.io
security:
  - apiKeyAuth: []
paths:
  /portfolio-forecasts/v1alpha1/submissions:
    get:
      summary: List stored delivery days
      description: >-
        List every delivery day the forecast service holds, newest first, with
        the `input_hash` of its stored submission and whether that exact input
        was already processed downstream.
      operationId: listPortfolioForecasts
      responses:
        '200':
          description: The stored delivery days.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForecastListResponse'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/Throttled'
        '502':
          $ref: '#/components/responses/ServiceUnavailable'
        '504':
          $ref: '#/components/responses/ServiceTimedOut'
components:
  schemas:
    ForecastListResponse:
      type: object
      description: The delivery days the forecast service holds, newest first.
      properties:
        days:
          type: array
          items:
            $ref: '#/components/schemas/ForecastDaySummary'
      required:
        - days
      example:
        days:
          - delivery_day: '2026-09-02'
            input_hash: eb50caedb5b4ccb0ca4c86cda9546f966cabac1d7daedf59e5260dd4b01197f2
            source: customer
            processed: false
          - delivery_day: '2026-09-01'
            input_hash: 3b1f0c8e6d2a4f7b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b
            source: customer
            processed: true
    ForecastDaySummary:
      type: object
      description: One stored delivery day.
      properties:
        delivery_day:
          type: string
          format: date
        input_hash:
          type: string
          description: >-
            Content hash of the stored submission. Equals the `input_hash` of
            the acknowledgment that accepted it.
        source:
          type: string
          enum:
            - customer
            - generated
          description: >-
            `customer`: a submitted forecast. `generated`: the forecast service
            built the day from mirrored data.
        processed:
          type: boolean
          description: >-
            True once the schedules for exactly this input were submitted
            downstream and accepted.
      required:
        - delivery_day
        - input_hash
        - source
        - processed
  responses:
    Forbidden:
      description: >-
        The authenticated organization is not authorized to use the Portfolio
        Forecasts API.
    Throttled:
      description: The request is throttled.
      headers:
        Retry-After:
          schema:
            type: string
          description: Time to wait before retrying.
    ServiceUnavailable:
      description: Forecast service unavailable.
      content:
        application/json:
          schema:
            type: object
            properties:
              detail:
                const: Forecast service unavailable
            required:
              - detail
    ServiceTimedOut:
      description: Forecast service timed out.
      content:
        application/json:
          schema:
            type: object
            properties:
              detail:
                const: Forecast service timed out
            required:
              - detail
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization

````