---
title: "Quote List Checkout"
method: POST
path: "/api/v1/commerce/list-quote"
tags: ["commerce", "commerce"]
---

# Quote List Checkout

`POST /api/v1/commerce/list-quote`

## Request

- Base URL: `https://app.goodleads.club` (the document declares no server; this is the origin it was published from)
- URL: `https://app.goodleads.club/api/v1/commerce/list-quote`
- Auth: API key in header `X-API-Key`

The exact quote a list checkout would freeze — after every guard, before
anything is written (no saved list, product, order, manifest or Stripe
session). What a buyer's page prints before Pay when it cannot derive the
price itself: a purchase that wants one contact (`contact`) charges today
only what carries it and holds the rest under a ceiling (ADR-052 amendment
2026-10-16). Same refusals as the checkout, as 4xx with the quote.

## Request body

- CheckoutRequest: Buy a shelf product (`product_id`) OR a shaped list (ADR-045) — never both. A list is either a saved one (`list_id`) or an inline shape (`states` + `filters`); the buyer picks a lane, an optional cap (the dial) and how the records arrive. `price_rule_version` / `expected_total_cents` are the quote the buyer saw — when either has moved, the answer is a 409 carrying the fresh quote, never a silent different charge.
  - `product_id` string, nullable
  - `success_url` string, nullable
  - `cancel_url` string, nullable
  - `customer_email` string, nullable
  - `list_id` string, nullable
  - `states` string[], nullable
  - `filters` object[], nullable
  - `include_held` boolean
  - `include_existing` boolean
  - `lane` string, nullable
  - `cap` object, nullable
  - `channel` string, nullable
  - `contact` string, nullable
  - `delivery` string
  - `crm_connection_id` string, nullable
  - `connector_crm_name` string, nullable
  - `price_rule_version` integer, nullable
  - `expected_total_cents` integer, nullable
  - `offer_code` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/goodleads/apis/formation-gtm-api.md) · [All operations](https://skmtc.dev/goodleads/apis/formation-gtm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/goodleads/apis/formation-gtm-api/revisions/2068d13a82cf?raw)