> ## Documentation Index > Fetch the complete documentation index at: https://docs.stella-commerce.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Checkout > Get checkout by ID. Accepts either auth shape: * **Storefront token** (`X-Site-ID` + `X-Stella-Token`) — for the merchant's own storefront calling back into Stella. * **Per-checkout token** (`Authorization: Bearer chk_…`) — for the Stella-hosted `checkout-web` SPA which runs on a different origin and doesn't carry the merchant's storefront token. The `chk_…` Bearer is preferred when present because it carries the eager-loaded checkout already (saves a query) and binds the request to one specific checkout (defense in depth on top of the URL `checkout_id`). ## OpenAPI ````yaml /api-reference/openapi.json get /api/storefront/checkout/{checkout_id} openapi: 3.1.0 info: title: Agentic Commerce API description: |2- Agentic Commerce API - E-commerce Backend ## APIs ### Dashboard API (`/api/dashboard`) Authenticated endpoints for merchant management: - Products, Variants, Options - Inventory management - Orders and fulfillment - Customers - Collections ### Storefront API (`/api/storefront`) Public endpoints for client websites: - Product catalog - Collections - Cart management - Checkout ### Sync API (`/api/sync`) Integration endpoints for zunkiree-search: - Product sync - Availability checks - Order creation from AI widget version: 1.0.0 servers: [] security: [] paths: /api/storefront/checkout/{checkout_id}: get: tags: - Storefront - Checkout summary: Get Checkout description: |- Get checkout by ID. Accepts either auth shape: * **Storefront token** (`X-Site-ID` + `X-Stella-Token`) — for the merchant's own storefront calling back into Stella. * **Per-checkout token** (`Authorization: Bearer chk_…`) — for the Stella-hosted `checkout-web` SPA which runs on a different origin and doesn't carry the merchant's storefront token. The `chk_…` Bearer is preferred when present because it carries the eager-loaded checkout already (saves a query) and binds the request to one specific checkout (defense in depth on top of the URL `checkout_id`). operationId: get_checkout_api_storefront_checkout__checkout_id__get parameters: - name: checkout_id in: path required: true schema: type: string format: uuid title: Checkout Id - name: authorization in: header required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/CheckoutResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: CheckoutResponse: properties: id: type: string format: uuid title: Id cart_id: type: string format: uuid title: Cart Id email: type: string title: Email shipping_address: $ref: '#/components/schemas/AddressSchema' billing_address: $ref: '#/components/schemas/AddressSchema' items: items: $ref: '#/components/schemas/CartItemResponse' type: array title: Items subtotal: type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ title: Subtotal tax_amount: type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ title: Tax Amount shipping_amount: type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ title: Shipping Amount total: type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ title: Total currency: type: string title: Currency status: type: string title: Status payment_intent_id: anyOf: - type: string - type: 'null' title: Payment Intent Id order_id: anyOf: - type: string format: uuid - type: 'null' title: Order Id created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At completed_at: anyOf: - type: string format: date-time - type: 'null' title: Completed At type: object required: - id - cart_id - email - shipping_address - billing_address - items - subtotal - tax_amount - shipping_amount - total - currency - status - created_at - updated_at title: CheckoutResponse description: Schema for checkout response. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError AddressSchema: properties: first_name: anyOf: - type: string - type: 'null' title: First Name last_name: anyOf: - type: string - type: 'null' title: Last Name company: anyOf: - type: string - type: 'null' title: Company address1: anyOf: - type: string - type: 'null' title: Address1 address2: anyOf: - type: string - type: 'null' title: Address2 city: anyOf: - type: string - type: 'null' title: City state: anyOf: - type: string - type: 'null' title: State postal_code: anyOf: - type: string - type: 'null' title: Postal Code country: anyOf: - type: string - type: 'null' title: Country phone: anyOf: - type: string - type: 'null' title: Phone type: object title: AddressSchema description: >- Schema for address. Fields are optional to support simpler address formats from AI widget. CartItemResponse: properties: id: type: string format: uuid title: Id variant_id: type: string format: uuid title: Variant Id product_id: type: string format: uuid title: Product Id product_name: type: string title: Product Name variant_name: type: string title: Variant Name sku: anyOf: - type: string - type: 'null' title: Sku image_url: anyOf: - type: string - type: 'null' title: Image Url price: type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ title: Price quantity: type: integer title: Quantity total: type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ title: Total type: object required: - id - variant_id - product_id - product_name - variant_name - sku - image_url - price - quantity - total title: CartItemResponse description: Schema for cart item in response. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ````