---
title: "List Proposals"
method: GET
path: "/internal/marketing-preset-proposals"
tags: ["internal"]
---

# List Proposals

`GET /internal/marketing-preset-proposals`

## Request

- Base URL: `https://api.kobaltlabs.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kobaltlabs.com/internal/marketing-preset-proposals`
- Auth: none declared

Staged proposals, newest first, optionally narrowed to one customer or one state.

## Query parameters

- `company_id` string, uuid, nullable
- `proposal_status` 'open' | 'applied' | 'discarded': Where a proposal is in its one-way life. `open` is the only state that accepts edits or applies. A proposal reaches `applied` when every item on it has been written, so a reviewer who approves three of five rows leaves it `open` and comes back for the rest rather than stranding them.
- `limit` integer

## Response `200`

Successful Response

- MarketingPresetProposalSummary[]
  - `proposal_id` string, uuid, required
  - `company_id` string, uuid, required
  - `company_name` string, nullable, required
  - `title` string, required
  - `notes` string, nullable, required
  - `status` 'open' | 'applied' | 'discarded', required: Where a proposal is in its one-way life. `open` is the only state that accepts edits or applies. A proposal reaches `applied` when every item on it has been written, so a reviewer who approves three of five rows leaves it `open` and comes back for the rest rather than stranding them.
  - `revision` integer, required
  - `created_by_email` string, nullable, required
  - `created` string, required
  - `item_count` integer, required
  - `applied_count` integer, required
  - `last_applied_at` string, nullable, required
  - `last_applied_by_email` string, nullable, required
  - `review_url` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api.md) - [All operations](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api/revisions/8587332d5e43?raw)