---
title: "List Forecast Submissions"
method: GET
path: "/v1/forecasting/submissions/"
tags: ["forecast_submissions"]
---

# List Forecast Submissions

`GET /v1/forecasting/submissions/`

## Request

- Base URL: `https://api.glyphic.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.glyphic.ai/v1/forecasting/submissions/`
- Auth: API key in header `X-API-Key`

List historic forecast submissions for the API key's organization.

Results include resubmissions and are ordered by submission time, newest
first. Omit `user_id` to read the whole organization. Embedded deal
snapshots are included only when `include_deals` is true; `deal_count`
always describes the frozen snapshot size.

## Query parameters

- `user_id` string[], nullable: Filter to submissions by one or more Airspeed user IDs.
- `period` string, nullable: Filter to one exact period label from forecasting config.
- `board_id` string, nullable: Filter to one forecast board ID from forecasting config.
- `submitted_after` string, date-time, nullable: Include submissions posted at or after this UTC timestamp.
- `submitted_before` string, date-time, nullable: Include submissions posted at or before this UTC timestamp.
- `include_deals` boolean: Include each rep submission's frozen deal snapshot.
- `cursor` string, nullable: Cursor for pagination
- `limit` integer: Number of items per page
- `direction` 'next' | 'prev': Pagination direction

## Response `200`

Successful Response

- PaginatedResponseForecastSubmission
  - `data` ForecastSubmission[], required
    - `id` string, required
    - `submitted_at` string, date-time, required
    - `submitted_by` ForecastSubmitter, required: Public identity for the person who posted a forecast.
      - `id` string, required
      - `name` string, required
      - `email` string, email, required
    - `period_start` string, date, required
    - `period_end` string, date, required
    - `period_label` string, required
    - `board_id` string, nullable
    - `amounts` ForecastSubmissionAmounts, required: Public amounts keyed by the organization's visible categories.
      - `forecast` number, required
      - `closed_won` number, nullable, required
    - `quota` number, nullable
    - `comment` string, nullable
    - `currency` string, nullable
    - `deal_count` integer, required
    - `is_manager_forecast` boolean, required
    - `deals` ForecastSubmissionDeal[], nullable
      - `id` string, required
      - `name` string, required
      - `amount` number, nullable
      - `forecast_category` string, nullable
      - `is_closed` boolean, required
      - `is_won` boolean, nullable
  - `pagination` CursorPagination, required: Cursor-based pagination.
    - `next_cursor` string, nullable
    - `previous_cursor` string, nullable

## Other responses

- `401`: Unauthorized - Invalid or missing API key
- `404`: Forecasting not found
- `422`: Validation Error

## Changes

- **2026-09-30** `f8d0e97df0a5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/glyphic/apis/airspeed-api/changes/v1/forecasting/submissions/get.md)

---

[API](https://skmtc.dev/glyphic/apis/airspeed-api.md) - [All operations](https://skmtc.dev/glyphic/apis/airspeed-api/llms.txt) - [OpenAPI document](https://skmtc.dev/glyphic/apis/airspeed-api/revisions/6ec6a32aa851?raw)