---
title: "List Pitches"
method: GET
path: "/api/v1/pitches"
tags: ["Pitch Workspace"]
---

# List Pitches

`GET /api/v1/pitches`

Returns all non-deleted pitch workspace reports for the calling organization, ordered by creation date (newest first). Pitches are org-level resources and are not scoped to a single website.

Requires a **global (organization-scoped) API key**. Website-scoped keys are rejected with `403 Forbidden`.

## Response `200`

Successful response with the list of pitches.

- object
  - `pitches` PitchSummary[], required
    - `id` string, uuid, required — Unique identifier for the pitch.
    - `company_name` string, required — Display name of the company the pitch was created for.
    - `company_url` string, required — The company website domain (without protocol).
    - `company_description` string, required — Short description of the company captured at pitch creation time.
    - `status` 'draft' | 'processing' | 'completed' | 'failed', required — Current state of the pitch run. `processing` means the workflow is still generating prompts and responses; `completed` means the report is ready; `failed` means the run errored.
    - `created_at` string, date-time, required — ISO 8601 timestamp (UTC) for when the pitch was created.
    - `country` string, nullable — Target country for the pitch, or `null` if no country was set.
    - `language` string, nullable — Target language for the pitch, or `null` if no language was set.
    - `type` 'pitch_workspace' | 'landing_page', nullable — Pitch variant. `pitch_workspace` is the standard pitch report; `landing_page` is generated from a landing page URL. `null` for legacy pitches predating the field.

## Other responses

- `401` — Unauthorized — invalid or missing API key.
- `403` — Forbidden — a website-scoped API key was used. Pitches are org-level resources; use a global API key.
- `500` — Internal server error.

---

[API](https://skmtc.net/athenahq/apis/athenahq-api.md) · [All operations](https://skmtc.net/athenahq/apis/athenahq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/athenahq/athenahq-api/revisions/6c5d71622cb9/schema)