---
title: "List checkout configurations"
method: GET
path: "/checkout_configurations"
tags: ["Checkout Configurations"]
---

# List checkout configurations

`GET /checkout_configurations`

Lists checkout configurations for an account.

## Query parameters

- `account_id` string, required
- `plan_id` string
- `created_before` string
- `created_after` string
- `order` 'created_at'
- `direction` 'asc' | 'desc'
- `first` integer
- `after` string

## Response `200`

checkout configurations listed

- object
  - `data` object[], required
    - `account_id` string, required — Account ID, prefixed `biz_`.
    - `affiliate_code` string, nullable — Affiliate code applied at checkout, or `null` when none is set.
    - `created_at` string, required — When the checkout configuration was created, as an ISO 8601 timestamp.
    - `currency` string, nullable — Currency used for setup-mode payment method availability; defaults to `usd` when omitted.
    - `id` string, required — Checkout configuration ID, prefixed `ch_`.
    - `metadata` object, nullable — Custom key-value metadata copied to payments and memberships. `null` without the `checkout_configuration:basic:read` scope.
    - `mode` 'payment' | 'setup', required — Controls whether checkout charges the buyer immediately or saves payment details for later.
    - `payment_method_configuration` object, nullable — Payment method overrides for this checkout. `null` when it uses the plan or platform defaults.
      - `disabled` string[] — Payment methods explicitly disabled for checkout.
      - `enabled` string[] — Payment methods explicitly enabled for checkout.
      - `include_platform_defaults` boolean — Whether platform default payment methods are included.
    - `plan` object, nullable — Plan used for payment checkout. `null` in setup mode.
      - `adaptive_pricing_enabled` boolean, required — Whether this plan accepts local currency payments via adaptive pricing.
      - `billing_period` integer, nullable, required — Recurring billing interval in days, such as 30 for monthly or 365 for annual. `null` for one-time plans.
      - `currency` string, required — Three-letter ISO currency code for the plan's prices.
      - `expiration_days` integer, nullable, required — Access duration in days for expiration-based plans.
      - `id` string, required — Plan ID, prefixed `plan_`.
      - `initial_price` number, required — Initial purchase price in the plan currency.
      - `plan_type` 'renewal' | 'one_time', required — Billing model for the plan.
      - `release_method` 'buy_now' | 'waitlist', required — Sales method for the plan.
      - `renewal_price` number, required — Recurring price charged each billing period.
      - `three_ds_level` 'mandate_challenge' | 'frictionless' | 'null', nullable, required — 3D Secure behavior for this plan, or `null` to use the account default.
      - `trial_period_days` integer, nullable, required — Free trial days before the first renewal charge.
      - `visibility` 'visible' | 'hidden' | 'archived' | 'quick_link', required — Whether the plan is visible to customers or hidden from public view.
    - `purchase_url` string, nullable — Checkout URL you can send to customers.
    - `redirect_url` string, nullable — URL customers are sent to after checkout, or `null` when no redirect is configured.
    - `three_ds_level` 'mandate_challenge' | 'frictionless' | 'null', nullable — 3D Secure behavior for this checkout, or `null` to use the account default.
    - `updated_at` string, required — When the checkout configuration was last updated, as an ISO 8601 timestamp.
  - `page_info` object, required
    - `end_cursor` string, nullable, required
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable, required

## Other responses

- `400` — Invalid Parameters
- `401` — Unauthorized

---

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