---
title: "Get Proposal"
method: GET
path: "/internal/marketing-preset-proposals/{proposal_id}"
tags: ["internal"]
---

# Get Proposal

`GET /internal/marketing-preset-proposals/{proposal_id}`

## 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/{proposal_id}`
- Auth: none declared

The proposal plus everything the review page renders against it.

## Path parameters

- `proposal_id` string, uuid, required

## Response `200`

Successful Response

- MarketingPresetProposalDetail: Everything the review page needs, in one response. One call rather than five: the page cannot render a checkbox grid without the regulation list, cannot diff an `update` without the current product lines, and cannot offer a team or a marketing standard without those lists — so fetching them separately only buys four more ways for the page to be half-drawn.
  - `proposal` MarketingPresetProposalSummary, required: A proposal without its items — the listing, and the MCP status read.
    - `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
  - `items` ProposedProductLine[], required
    - `key` string, required
    - `operation` 'create' | 'update': Whether an item creates a product line or edits one that exists.
    - `preset_id` string, uuid, nullable
    - `name` string, required
    - `description` string, nullable
    - `program_types` MarketingProgramType[]
    - `internal_file_ids` string[]
    - `guideline_notes` string[]
    - `marketing_team_id` string, uuid, nullable
    - `rationale` string, nullable
    - `approved` boolean
    - `applied_preset_id` string, uuid, nullable
  - `program_types` ProgramTypeRegulations[], required
    - `program_type` 'Consumer UDAAP' | 'UK Financial Promotions' | 'FINRA' | 'Reg E' | 'Reg DD' | 'Card Brand Rules' | 'ECOA (Reg B)' | 'TILA (Reg Z)' | 'CAN-SPAM' | 'FDIC Advertising' | 'Fair Housing Logo' | 'FCRA Consumer Rights' | 'FCRA Prescreened Offers' | 'Kansas UCCC/KMBA' | 'Reg CC' | 'SCRA/MLA' | 'B2B UDAAP' | 'Reg II' | 'TCPA' | 'FTC Endorsement Guides' | 'GLBA / Privacy' | 'Prepaid Rule' | 'Sweepstakes & Giveaways', required
    - `regulations` string[], required
    - `company_override` boolean, required
  - `existing_product_lines` ExistingProductLine[], required
    - `preset_id` string, uuid, required
    - `name` string, required
    - `description` string, nullable, required
    - `program_types` MarketingProgramType[], required
    - `marketing_team_id` string, uuid, nullable, required
    - `marketing_team_name` string, nullable, required
    - `internal_file_ids` string[], required
    - `usage_count` integer, required
  - `files` ProposalFileOption[], required
    - `file_id` string, uuid, required
    - `filename` string, required
  - `teams` ProposalTeamOption[], required
    - `team_id` string, uuid, required
    - `name` string, required

## Other responses

- `422`: Validation Error

---

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