> ## Documentation Index > Fetch the complete documentation index at: https://developers.redo.com/llms.txt > Use this file to discover all available pages before exploring further. # List checkout A/B tests > List the store's checkout A/B tests, newest first: whether each is running or concluded, when it ran, and its treatments with their traffic weights. This returns test metadata only, not statistical results. A test has a winner only when it concluded to a treatment other than the control. When `concludedToControl` is `true`, no treatment has `isWinner` set, and the test did not produce a winner. Requires the [`checkout_read`](/docs/api-reference/scopes) scope. ## OpenAPI ````yaml /api-schema/openapi.yaml get /stores/{storeId}/checkout-ab-tests openapi: 3.1.0 info: contact: email: engineering-admin@getredo.com name: Redo Engineering description: | ## Endpoints Endpoints are authenticated using the Bearer authorization scheme, using the REDO_API_SECRET. ```txt GET /v2.2/resource HTTP/1.1 Authorization: Bearer 77bb7598b7a972475cc7c7e171ec33af Host: api.getredo.com ``` ## Webhooks Webhooks are authenticated using the Bearer authorization scheme, using a secret supplied by the subscriber. ```txt POST /events HTTP/1.1 Authorization: Bearer subscriberauth123 Host: subscriber.example.com ``` Webhook events are delivered in order for each individual subject (e.g. return). If the response is not a 2xx status code, the event will be retried multiple times before discarding it. title: Redo API version: 2.2.1 servers: - url: https://api.getredo.com/v2.2 security: [] tags: - description: >- Group several products under one product shoppers buy, so a returned bundle can be broken back into the products it contains. name: Bundles - description: >- Read the store's checkout A/B tests, which split shoppers between checkout treatments to measure which converts better. name: Checkout A/B Tests - name: Checkout Buttons - description: >- Manage the shipping methods shown at checkout. A checkout experience is a named group of shipping methods; the store's checkout tree decides which shoppers see which experience. name: Checkout Experiences - name: Coverage Info - name: Coverage Products - name: Custom Events - name: Customer Portal - name: Customer Subscriptions - name: Customers - name: Inbound Shipments - name: Inventory Items - name: Inventory Levels - name: Invoices - name: Merchant Admin - name: Orders - name: Products - name: Returns - description: >- Push orders into Redo from a commerce platform Redo does not support directly, so shoppers can return them. name: Returns Custom Integration - name: Storefront - name: Webhooks paths: /stores/{storeId}/checkout-ab-tests: summary: Checkout A/B Tests parameters: - $ref: '#/components/parameters/store-id.param' get: tags: - Checkout A/B Tests summary: List checkout A/B tests description: > List the store's checkout A/B tests, newest first: whether each is running or concluded, when it ran, and its treatments with their traffic weights. This returns test metadata only, not statistical results. A test has a winner only when it concluded to a treatment other than the control. When `concludedToControl` is `true`, no treatment has `isWinner` set, and the test did not produce a winner. Requires the [`checkout_read`](/docs/api-reference/scopes) scope. operationId: Checkout A/B tests list parameters: - $ref: '#/components/parameters/checkout-ab-test-include-deleted.param' responses: '200': content: application/json: schema: $ref: '#/components/schemas/checkout-ab-test-list-response.schema' examples: abTests: summary: A running test and one that concluded to a variant value: abTests: - id: 66c4a1b2e4b0a1d2c3f4a5b6 name: Free shipping threshold description: Does a $50 free shipping threshold lift AOV? active: true isConcluded: false concludedToControl: false startDate: '2026-09-15T00:00:00.000Z' createdAt: '2026-09-14T18:22:10.000Z' treatments: - name: Control weight: 50 isControl: true isWinner: false - name: $50 threshold weight: 50 isControl: false isWinner: false - id: 66a0e7d3e4b0a1d2c3f4a5c1 name: Express upsell description: Show express shipping first. active: false isConcluded: true concludedToControl: false startDate: '2026-07-01T00:00:00.000Z' endDate: '2026-08-01T00:00:00.000Z' createdAt: '2026-06-30T12:00:00.000Z' treatments: - name: Control weight: 50 isControl: true isWinner: false - name: Express first weight: 50 isControl: false isWinner: true totalCount: 2 description: Success default: content: application/problem+json: schema: $ref: '#/components/schemas/error.schema' description: Error security: - Bearer: [] components: parameters: store-id.param: description: Store ID in: path name: storeId required: true schema: example: 64e5a8a1af49a89df37e4ee7 type: string checkout-ab-test-include-deleted.param: description: >- `true` also returns deleted A/B tests. Omit, or pass `false`, to return only tests that have not been deleted. in: query name: includeDeleted required: false schema: enum: - 'true' - 'false' type: string schemas: checkout-ab-test-list-response.schema: properties: abTests: description: The store's checkout A/B tests, newest first. items: $ref: '#/components/schemas/checkout-ab-test.schema' type: array totalCount: description: Number of A/B tests returned. example: 2 maximum: 9007199254740991 minimum: -9007199254740991 type: integer required: - abTests - totalCount title: Checkout A/B test list type: object error.schema: description: >- Problem details. See [RFC 7807 Section 3](https://datatracker.ietf.org/doc/html/rfc7807#section-3). properties: detail: description: Human-readable description of the problem. title: Detail type: string instance: description: A URI reference that identifies this problem. format: uri-reference type: string title: description: Human-readable summary of the problem type. title: Title type: string type: default: about:blank description: A URI reference that identifies the problem type. format: uri-reference type: string title: Problem details type: object checkout-ab-test.schema: properties: id: description: A/B test ID. example: 66c4a1b2e4b0a1d2c3f4a5b6 type: string name: description: Test name. Omitted when the merchant has not named the test. type: string description: description: Merchant-written description of the test. type: string active: description: True while the test is running. type: boolean isConcluded: description: True once the test has been concluded. type: boolean concludedToControl: description: >- True when the test concluded back to the control treatment. Such a test has no winner. type: boolean startDate: description: When the test started. Omitted if it never started. format: date-time type: string endDate: description: When the test ended. Omitted while it is running. format: date-time type: string createdAt: description: When the test was created. format: date-time type: string treatments: description: The arms of the test, control included. items: $ref: '#/components/schemas/checkout-ab-test-treatment.schema' type: array required: - id - description - active - isConcluded - concludedToControl - createdAt - treatments title: Checkout A/B test type: object checkout-ab-test-treatment.schema: properties: name: description: Treatment name. type: string weight: description: Share of traffic assigned to this treatment, as a percentage. type: number isControl: description: True for the control arm the variants are measured against. type: boolean isWinner: description: >- True only when the test concluded to this treatment and it is not the control. type: boolean required: - name - weight - isControl - isWinner title: Checkout A/B test treatment type: object securitySchemes: Bearer: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.