> ## Documentation Index > Fetch the complete documentation index at: https://developers.nova.money/llms.txt > Use this file to discover all available pages before exploring further. # Checkout Pages API — List and Retrieve Checkout Pages > REST API endpoints for Nova.Pay checkout pages. List all pages, retrieve a single page, and query payments associated with a checkout page. Checkout pages are the hosted payment forms you create in Nova.Pay. Each page can carry one or more products, accept multiple payment methods, and be customised with your brand colours and logo. The endpoints below let you programmatically list your pages, fetch their full configuration, and inspect the payments that have been made through them. **Base URL:** `https://pay.nova.money/api/v1` *** ## List checkout pages Authentication is required for all checkout-page endpoints. Pass your API key in the `Authorization` header as a Bearer token. Retrieve a paginated list of your checkout pages. You can narrow the results with the optional query parameters below. ```http theme={null} GET /checkout_pages ``` ### Query parameters Free-text search string. Matches against the page title and other indexed fields. When `true`, only returns pages that have at least one product attached. When `false`, returns pages with no products. Filter pages to only those that include any of the specified product IDs. Pass multiple values as repeated query params: `product_ids[]=1&product_ids[]=2`. ### Response Returns an array of **CheckoutPageSummary** objects. ```bash cURL theme={null} curl --request GET \ --url "https://pay.nova.money/api/v1/checkout_pages?has_products=true" \ --header "Authorization: Bearer YOUR_API_KEY" ``` ```json Example response theme={null} [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "page_title": "Summer Sale Checkout", "main_color": "#6366f1", "currency": "BRL", "gateway": "stripe", "public_key": "pk_live_xxxxxxxxxxxx", "subscription": false, "enable_coupons": true, "company_id": 42 } ] ``` *** ## Retrieve a checkout page Fetch the full configuration for a single checkout page by its UUID. ```http theme={null} GET /checkout_pages/{id} ``` ### Path parameters The UUID of the checkout page. ### Response Returns a **CheckoutPageShow** object, which extends CheckoutPageSummary with the full set of fields listed below. Unique identifier for the checkout page. Specifies at which step of the checkout flow customer data is collected. Typical values are `"start"` or `"end"`. The payment gateway configured for this page (e.g. `"stripe"`, `"pagarme"`). Hex colour code used as the primary brand colour on the hosted page. The display title shown to customers on the checkout page. URL of the logo image displayed on the checkout page. ISO 4217 currency code (e.g. `"BRL"`, `"USD"`). Navigation menu items configured for the page. The gateway public key used to tokenise card data on the client side. Whether the checkout page is configured for recurring / subscription billing. Whether coupon code entry is enabled on this page. When `true`, the hosted page allows indexing by search engine crawlers. When `true`, the customer must select a scheduled date before completing checkout. When `true`, the customer may split the payment across two credit cards. ID of the Nova.Pay company that owns this checkout page. An optional product offered as an upsell after the main purchase. Product ID. Product name. Arbitrary HTML/JS snippet injected into the hosted page (e.g. tracking pixels). The pre-selected payment plan shown to the customer on page load. Payment plan ID (e.g. `"42-1"`). Human-readable label. Payment method for this plan. Third-party integration configuration (webhooks, analytics, CRM connections, etc.). The products attached to this checkout page. Internal product ID. Public-facing unique identifier for the product. Product name. Product description shown to customers. Category of the product (e.g. `"digital"`, `"physical"`). Whether the product is sold as a subscription. Product billing type. Recurrence interval for subscriptions (e.g. `"monthly"`). Maximum number of units a customer can purchase. Unit price of the product. URL of the product image. Whether the customer can choose a quantity greater than one. Whether this product is highlighted as recommended. *** ## List payments for a checkout page Returns all payments submitted through a given checkout page. ```http theme={null} GET /checkout_pages/{id}/payments ``` ### Path parameters The UUID of the checkout page. ### Query parameters Filter the results to specific payments. Each value may be either a `gateway_id` (e.g. `"pay_abc123"`) or an internal payment ID. Pass multiple values as repeated query params: `ids[]=pay_abc123&ids[]=pay_def456`. ### Response Returns an **array of PaymentStatus** objects, or HTTP **204 No Content** if no payments have been made through this page yet. ```json Example response theme={null} [ { "gateway_id": "pay_abc123", "status": "paid" }, { "gateway_id": "pay_def456", "status": "waiting_payment" } ] ``` The payment identifier issued by the gateway (e.g. a Stripe PaymentIntent ID). Current status of the payment. Common values: `paid`, `waiting_payment`, `failed`, `cancelled`. ## Related topics - [Nova.Pay Checkout Flow: Pages, Carts, and Charge Links](/concepts/checkout-flow.md) - [Payment Plans API — List and Retrieve Installment Options](/api-reference/payment-plans.md) - [Products API — List, Create, and Retrieve Products](/api-reference/products.md) - [Carts API — Create, Retrieve, and Pay Nova.Pay Carts](/api-reference/carts.md) - [Nova.Pay API: Payments, Checkout & Order Management](/introduction.md)