> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve a checkout configuration

> Retrieves a checkout configuration by ID. This endpoint is public so a checkout page can load from the configuration URL.



## OpenAPI

````yaml /openapi/api-v1-native.yml get /checkout_configurations/{id}
openapi: 3.1.0
info:
  title: Whop API
  description: >-
    Hand-written V1 endpoints. Merged into the GraphqlRestProxy-generated schema
    at build time.
  version: v1
servers:
  - url: https://{defaultHost}
    variables:
      defaultHost:
        default: api.whop.com/api/v1
security: []
paths:
  /checkout_configurations/{id}:
    parameters:
      - $ref: '#/components/parameters/ApiVersionDate'
      - name: id
        in: path
        required: true
        description: The ID of the checkout configuration.
        schema:
          type: string
    get:
      tags:
        - Checkout Configurations
      summary: Retrieve a checkout configuration
      description: >-
        Retrieves a checkout configuration by ID. This endpoint is public so a
        checkout page can load from the configuration URL.
      operationId: retrieveCheckoutConfiguration
      responses:
        '200':
          description: checkout configuration found (unauthenticated)
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: Checkout configuration ID, prefixed `ch_`.
                  created_at:
                    type: string
                    description: >-
                      When the checkout configuration was created, as an ISO
                      8601 timestamp.
                  updated_at:
                    type: string
                    description: >-
                      When the checkout configuration was last updated, as an
                      ISO 8601 timestamp.
                  company_id:
                    type: string
                    description: Account ID, prefixed `biz_`.
                  mode:
                    type: string
                    enum:
                      - payment
                      - setup
                    description: >-
                      Checkout mode: `payment` collects payment now; `setup`
                      saves payment details for later.
                  currency:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Currency used for setup-mode payment method availability;
                      defaults to `usd` when omitted.
                  plan:
                    type:
                      - object
                      - 'null'
                    description: Plan used for payment checkout. `null` in setup mode.
                    properties:
                      id:
                        type: string
                        description: Plan ID, prefixed `plan_`.
                      visibility:
                        type: string
                        description: >-
                          Whether the plan is visible to customers or hidden
                          from public view.
                      plan_type:
                        type: string
                        description: >-
                          Billing model for the plan: `renewal` (recurring) or
                          `one_time` (single payment).
                      release_method:
                        type: string
                        description: >-
                          Sales method for the plan, such as `buy_now` or
                          `waitlist`.
                      currency:
                        type: string
                        description: Three-letter ISO currency code for the plan's prices.
                      billing_period:
                        type:
                          - integer
                          - 'null'
                        description: >-
                          Recurring billing interval in days, such as 30 for
                          monthly or 365 for annual. `null` for one-time plans.
                      expiration_days:
                        type:
                          - integer
                          - 'null'
                        description: Access duration in days for expiration-based plans.
                      initial_price:
                        type: number
                        description: Initial purchase price in the plan currency.
                      renewal_price:
                        type: number
                        description: Recurring price charged each billing period.
                      trial_period_days:
                        type:
                          - integer
                          - 'null'
                        description: Free trial days before the first renewal charge.
                      three_ds_level:
                        type:
                          - string
                          - 'null'
                        description: >-
                          3D Secure behavior for this plan, or `null` to use the
                          account default.
                      adaptive_pricing_enabled:
                        type: boolean
                        description: >-
                          Whether this plan accepts local currency payments via
                          adaptive pricing.
                    required:
                      - id
                      - visibility
                      - plan_type
                      - release_method
                      - currency
                      - billing_period
                      - expiration_days
                      - initial_price
                      - renewal_price
                      - trial_period_days
                      - three_ds_level
                      - adaptive_pricing_enabled
                  affiliate_code:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Affiliate code applied at checkout, or `null` when none is
                      set.
                  metadata:
                    type:
                      - object
                      - 'null'
                    description: >-
                      Custom key-value metadata copied to payments and
                      memberships. `null` without the
                      `checkout_configuration:basic:read` scope.
                  redirect_url:
                    type:
                      - string
                      - 'null'
                    description: >-
                      URL customers are sent to after checkout, or `null` when
                      no redirect is configured.
                  purchase_url:
                    type:
                      - string
                      - 'null'
                    description: Checkout URL you can send to customers.
                  three_ds_level:
                    type:
                      - string
                      - 'null'
                    description: >-
                      3D Secure behavior for this checkout, or `null` to use the
                      account default.
                  payment_method_configuration:
                    type:
                      - object
                      - 'null'
                    description: >-
                      Payment method overrides for this checkout. `null` when it
                      uses the plan or platform defaults.
                    properties:
                      enabled:
                        type: array
                        items:
                          type: string
                        description: Payment methods explicitly enabled for checkout.
                      disabled:
                        type: array
                        items:
                          type: string
                        description: Payment methods explicitly disabled for checkout.
                      include_platform_defaults:
                        type: boolean
                        description: Whether platform default payment methods are included.
                required:
                  - id
                  - created_at
                  - updated_at
                  - company_id
                  - mode
        '404':
          $ref: '#/components/responses/NotFound'
          description: not found
components:
  parameters:
    ApiVersionDate:
      name: Api-Version-Date
      in: header
      required: false
      schema:
        type: string
        example: 2026-07-08-1
      description: Pins the request to a dated API version.
  responses:
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/V1ErrorResponse'
  schemas:
    V1ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              description: Machine-readable error code.
            message:
              type: string
              description: Human-readable error message.
          required:
            - type
            - message
      required:
        - error

````