{
  "openapi": "3.1.0",
  "info": {
    "title": "Ordexs Storefront API",
    "version": "v1",
    "description": "Public, read-only store data — products, search, filters, collections,\npages, reviews, offers, delivery prices — plus a server price quote, for\nbuilding a store's front end anywhere: a headless website, a mobile app, or\nthe store's own AI-store scripts.\n\nIt is not the Ordexs Platform API (`https://api.ordexs.com/v1`, secret keys,\norders and customers). It reads only what the store's pages already show\nto anyone, so its token is a public identifier you can put in browser code.\n\nMoney is always `{ \"amount\": \"2900.00\", \"currency\": \"DZD\" }`: a decimal\nstring in the store's currency, with that currency's own decimals.\nLists are `{ object: \"list\", data, has_more, next_cursor }`; pass\n`next_cursor` back as `cursor` to continue.\n\nIds are plain UUIDs. Wherever an id is sent in, the Platform API's public\nform of the same row (`prod_…`, `var_…`, `ofr_…`) is accepted too.\n"
  },
  "servers": [
    {
      "url": "https://api.ordexs.com/storefront/v1/{store}",
      "description": "Outside apps and websites. Needs a Storefront API token.",
      "variables": {
        "store": {
          "default": "your-store",
          "description": "The store's handle, as in its address `https://<store>.myordexs.com`."
        }
      }
    },
    {
      "url": "https://{store}.myordexs.com/api/storefront/v1",
      "description": "On the store's own address (and its custom domain). Same-origin, no token — for the store's own pages and scripts.",
      "variables": {
        "store": {
          "default": "your-store"
        }
      }
    }
  ],
  "security": [
    {
      "StorefrontToken": []
    }
  ],
  "tags": [
    {
      "name": "Store",
      "description": "The store itself and its navigation."
    },
    {
      "name": "Products",
      "description": "Products, search, filters and suggestions."
    },
    {
      "name": "Collections",
      "description": "Collections and categories."
    },
    {
      "name": "Content",
      "description": "Pages and policies."
    },
    {
      "name": "Reviews and offers",
      "description": "Published reviews and live offers."
    },
    {
      "name": "Delivery",
      "description": "Regions, cities and delivery prices."
    },
    {
      "name": "Cart",
      "description": "A server price quote for a cart."
    }
  ],
  "paths": {
    "/store": {
      "get": {
        "operationId": "sfGetStore",
        "tags": [
          "Store"
        ],
        "summary": "Get the store",
        "description": "Name, logo, language, currency, country, contacts and payment methods. Use `currency.decimals` to format money.",
        "responses": {
          "200": {
            "description": "The store.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Store"
                },
                "example": {
                  "object": "store",
                  "name": "Atelier Nour",
                  "handle": "atelier-nour",
                  "url": "https://atelier-nour.myordexs.com",
                  "logo": "https://cdn.myordexs.com/…/logo-640.webp",
                  "language": "ar",
                  "direction": "rtl",
                  "currency": {
                    "code": "DZD",
                    "decimals": 2
                  },
                  "country": "DZ",
                  "accepting_orders": true,
                  "contact": {
                    "email": "hello@atelier-nour.example",
                    "phone": "0550 00 00 00",
                    "city": "Oran"
                  },
                  "social": [
                    {
                      "network": "instagram",
                      "label": "Instagram",
                      "url": "https://www.instagram.com/ateliernour/"
                    }
                  ],
                  "payment_methods": [
                    "cash_on_delivery"
                  ]
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "authentication_required",
          "invalid_token",
          "token_revoked",
          "wrong_store",
          "origin_not_allowed",
          "not_found",
          "rate_limited"
        ]
      }
    },
    "/navigation": {
      "get": {
        "operationId": "sfGetNavigation",
        "tags": [
          "Store"
        ],
        "summary": "Get the navigation",
        "description": "The store's menus as its themes build them — `main` (catalogue and collections) and `footer` (footer pages and policies).",
        "responses": {
          "200": {
            "description": "The navigation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Navigation"
                },
                "example": {
                  "object": "navigation",
                  "main": [
                    {
                      "title": null,
                      "kind": "catalog",
                      "path": "/products"
                    },
                    {
                      "title": "Dresses",
                      "kind": "collection",
                      "handle": "dresses",
                      "path": "/collections/dresses"
                    }
                  ],
                  "footer": [
                    {
                      "title": "About us",
                      "kind": "page",
                      "handle": "about",
                      "path": "/pages/about"
                    },
                    {
                      "title": "Returns",
                      "kind": "policy",
                      "handle": "refund",
                      "path": "/policies/refund"
                    }
                  ]
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "authentication_required",
          "invalid_token",
          "wrong_store",
          "rate_limited"
        ]
      }
    },
    "/products": {
      "get": {
        "operationId": "sfListProducts",
        "tags": [
          "Products"
        ],
        "summary": "List and search products",
        "description": "Published products, newest first unless `sort` says otherwise. Every\nfilter combines with the others. Unlisted products are never listed\n(they still open by handle).\n",
        "parameters": [
          {
            "$ref": "#/components/parameters/Query"
          },
          {
            "name": "collection",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 120
            },
            "description": "A collection handle. With it, `sort` defaults to the merchant's order."
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 80
            },
            "description": "A category key from `/categories`."
          },
          {
            "name": "tag",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 80
            }
          },
          {
            "name": "vendor",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 120
            }
          },
          {
            "name": "min_price",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[0-9]+(\\.[0-9]+)?$"
            },
            "description": "Lowest price, as a decimal string in the store's currency."
          },
          {
            "name": "max_price",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[0-9]+(\\.[0-9]+)?$"
            }
          },
          {
            "name": "available",
            "in": "query",
            "schema": {
              "type": "boolean"
            },
            "description": "`true`: only products a shopper can order now."
          },
          {
            "name": "option.<Name>",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Option values to match, comma-separated, e.g. `option.Size=M,L`. Up to 8 options, 20 values each."
          },
          {
            "name": "sort",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "newest",
                "oldest",
                "price_asc",
                "price_desc",
                "title",
                "relevance",
                "collection"
              ]
            },
            "description": "`relevance` needs `q`; `collection` needs `collection`."
          },
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of products.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductList"
                },
                "example": {
                  "object": "list",
                  "data": [
                    {
                      "object": "product",
                      "id": "3f2b1c0e-8d4a-4b7f-9c1e-2a5d6e7f8a90",
                      "handle": "linen-dress",
                      "title": "Linen dress",
                      "path": "/products/linen-dress",
                      "price": {
                        "min": {
                          "amount": "4500.00",
                          "currency": "DZD"
                        },
                        "max": {
                          "amount": "4900.00",
                          "currency": "DZD"
                        }
                      },
                      "compare_at_price": {
                        "amount": "5900.00",
                        "currency": "DZD"
                      },
                      "available": true,
                      "image": {
                        "url": "https://cdn.myordexs.com/…/linen-dress-1024.webp",
                        "alt": "Linen dress"
                      },
                      "images_count": 5,
                      "category": {
                        "key": "dresses",
                        "name": "Dresses"
                      },
                      "vendor": "Atelier Nour",
                      "tags": [
                        "summer"
                      ],
                      "options": [
                        {
                          "name": "Size",
                          "kind": "size",
                          "values": [
                            "S",
                            "M",
                            "L"
                          ]
                        },
                        {
                          "name": "Colour",
                          "kind": "color",
                          "values": [
                            "Sand",
                            "Olive"
                          ]
                        }
                      ],
                      "reviews": {
                        "count": 12,
                        "average": 4.6
                      }
                    }
                  ],
                  "has_more": true,
                  "next_cursor": "eyJzIjoibmV3ZXN0IiwiayI6IjIwMjYtMTEtMDEiLCJpIjoiLi4uIn0"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "invalid_request",
          "invalid_sort",
          "authentication_required",
          "invalid_token",
          "wrong_store",
          "rate_limited"
        ]
      }
    },
    "/products/{product}": {
      "get": {
        "operationId": "sfGetProduct",
        "tags": [
          "Products"
        ],
        "summary": "Get a product",
        "description": "One product by handle or id, with its variants, every photo, description, SEO and collections.",
        "parameters": [
          {
            "name": "product",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The product's handle, id, or Platform API id (`prod_…`)."
          }
        ],
        "responses": {
          "200": {
            "description": "The product.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Product"
                },
                "example": {
                  "object": "product",
                  "id": "3f2b1c0e-8d4a-4b7f-9c1e-2a5d6e7f8a90",
                  "handle": "linen-dress",
                  "title": "Linen dress",
                  "path": "/products/linen-dress",
                  "price": {
                    "min": {
                      "amount": "4500.00",
                      "currency": "DZD"
                    },
                    "max": {
                      "amount": "4900.00",
                      "currency": "DZD"
                    }
                  },
                  "compare_at_price": {
                    "amount": "5900.00",
                    "currency": "DZD"
                  },
                  "available": true,
                  "image": {
                    "url": "https://cdn.myordexs.com/…/linen-dress-1024.webp",
                    "alt": "Linen dress"
                  },
                  "images_count": 5,
                  "category": {
                    "key": "dresses",
                    "name": "Dresses"
                  },
                  "vendor": "Atelier Nour",
                  "tags": [
                    "summer"
                  ],
                  "options": [
                    {
                      "name": "Size",
                      "kind": "size",
                      "values": [
                        "S",
                        "M",
                        "L"
                      ]
                    }
                  ],
                  "reviews": {
                    "count": 12,
                    "average": 4.6
                  },
                  "description_html": "<p>Breathable linen, cut loose.</p>",
                  "description_text": "Breathable linen, cut loose.",
                  "product_type": "dress",
                  "seo": {
                    "title": "Linen dress",
                    "description": "Breathable linen, cut loose."
                  },
                  "images": [
                    {
                      "url": "https://cdn.myordexs.com/…/linen-dress-1024.webp",
                      "alt": "Linen dress"
                    }
                  ],
                  "variants": [
                    {
                      "object": "variant",
                      "id": "52f9c14c-bdae-4b7c-af1f-c04955623056",
                      "title": "M",
                      "options": {
                        "Size": "M"
                      },
                      "price": {
                        "amount": "4500.00",
                        "currency": "DZD"
                      },
                      "compare_at_price": {
                        "amount": "5900.00",
                        "currency": "DZD"
                      },
                      "available": true,
                      "preorder": false,
                      "image": null
                    }
                  ],
                  "collections": [
                    {
                      "handle": "dresses",
                      "title": "Dresses"
                    }
                  ]
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "not_found",
          "invalid_request",
          "authentication_required",
          "invalid_token",
          "wrong_store",
          "rate_limited"
        ]
      }
    },
    "/facets": {
      "get": {
        "operationId": "sfGetFacets",
        "tags": [
          "Products"
        ],
        "summary": "Get filter facets",
        "description": "What a filter menu can offer for the products in scope, with counts — categories, vendors, tags, the price range and option values. Bounded to the newest 5,000 products in scope.",
        "parameters": [
          {
            "$ref": "#/components/parameters/Query"
          },
          {
            "name": "collection",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The facets.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Facets"
                },
                "example": {
                  "object": "facets",
                  "products": 42,
                  "categories": [
                    {
                      "key": "dresses",
                      "name": "Dresses",
                      "count": 18
                    }
                  ],
                  "vendors": [
                    {
                      "value": "Atelier Nour",
                      "count": 9
                    }
                  ],
                  "tags": [
                    {
                      "value": "summer",
                      "count": 12
                    }
                  ],
                  "price": {
                    "min": {
                      "amount": "1900.00",
                      "currency": "DZD"
                    },
                    "max": {
                      "amount": "8900.00",
                      "currency": "DZD"
                    }
                  },
                  "options": [
                    {
                      "name": "Size",
                      "values": [
                        {
                          "value": "M",
                          "count": 30
                        },
                        {
                          "value": "L",
                          "count": 27
                        }
                      ]
                    }
                  ]
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "invalid_request",
          "authentication_required",
          "invalid_token",
          "wrong_store",
          "rate_limited"
        ]
      }
    },
    "/search/suggest": {
      "get": {
        "operationId": "sfSuggest",
        "tags": [
          "Products"
        ],
        "summary": "Suggest as the shopper types",
        "description": "Up to 6 products and 4 collections whose title matches. Meant for a search box; debounce on your side.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 2,
              "maxLength": 80
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Suggestions.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Suggestions"
                },
                "example": {
                  "object": "suggestions",
                  "query": "lin",
                  "products": [
                    {
                      "id": "3f2b1c0e-8d4a-4b7f-9c1e-2a5d6e7f8a90",
                      "handle": "linen-dress",
                      "title": "Linen dress",
                      "path": "/products/linen-dress",
                      "price": {
                        "amount": "4500.00",
                        "currency": "DZD"
                      },
                      "image": "https://cdn.myordexs.com/…/linen-dress-1024.webp"
                    }
                  ],
                  "collections": [
                    {
                      "handle": "linen",
                      "title": "Linen",
                      "path": "/collections/linen"
                    }
                  ]
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "invalid_request",
          "authentication_required",
          "invalid_token",
          "wrong_store",
          "rate_limited"
        ]
      }
    },
    "/collections": {
      "get": {
        "operationId": "sfListCollections",
        "tags": [
          "Collections"
        ],
        "summary": "List collections",
        "description": "The store's collections in the merchant's order, with product counts.",
        "parameters": [
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of collections.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CollectionList"
                },
                "example": {
                  "object": "list",
                  "data": [
                    {
                      "object": "collection",
                      "id": "6318d68d-8aef-4ae1-8e6c-578576a38551",
                      "handle": "dresses",
                      "title": "Dresses",
                      "path": "/collections/dresses",
                      "description_text": "Light dresses for warm days.",
                      "image": "https://cdn.myordexs.com/…/dresses-1024.webp",
                      "products_count": 18
                    }
                  ],
                  "has_more": false,
                  "next_cursor": null
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "invalid_request",
          "authentication_required",
          "invalid_token",
          "wrong_store",
          "rate_limited"
        ]
      }
    },
    "/collections/{collection}": {
      "get": {
        "operationId": "sfGetCollection",
        "tags": [
          "Collections"
        ],
        "summary": "Get a collection and its products",
        "description": "The collection and a page of its products, in the merchant's order by default. Takes every `/products` filter.",
        "parameters": [
          {
            "name": "collection",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The collection's handle or id."
          },
          {
            "$ref": "#/components/parameters/Query"
          },
          {
            "name": "sort",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "collection",
                "newest",
                "oldest",
                "price_asc",
                "price_desc",
                "title",
                "relevance"
              ]
            }
          },
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "description": "The collection.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Collection"
                },
                "example": {
                  "object": "collection",
                  "id": "6318d68d-8aef-4ae1-8e6c-578576a38551",
                  "handle": "dresses",
                  "title": "Dresses",
                  "path": "/collections/dresses",
                  "description_text": "Light dresses for warm days.",
                  "description_html": "<p>Light dresses for warm days.</p>",
                  "image": "https://cdn.myordexs.com/…/dresses-1024.webp",
                  "products_count": 18,
                  "seo": {
                    "title": "Dresses",
                    "description": null
                  },
                  "products": {
                    "object": "list",
                    "data": [
                      {
                        "object": "product",
                        "id": "3f2b1c0e-8d4a-4b7f-9c1e-2a5d6e7f8a90",
                        "handle": "linen-dress",
                        "title": "Linen dress",
                        "path": "/products/linen-dress",
                        "price": {
                          "min": {
                            "amount": "4500.00",
                            "currency": "DZD"
                          },
                          "max": {
                            "amount": "4900.00",
                            "currency": "DZD"
                          }
                        },
                        "compare_at_price": {
                          "amount": "5900.00",
                          "currency": "DZD"
                        },
                        "available": true,
                        "image": {
                          "url": "https://cdn.myordexs.com/…/linen-dress-1024.webp",
                          "alt": "Linen dress"
                        },
                        "images_count": 5,
                        "category": {
                          "key": "dresses",
                          "name": "Dresses"
                        },
                        "vendor": "Atelier Nour",
                        "tags": [
                          "summer"
                        ],
                        "options": [
                          {
                            "name": "Size",
                            "kind": "size",
                            "values": [
                              "S",
                              "M",
                              "L"
                            ]
                          },
                          {
                            "name": "Colour",
                            "kind": "color",
                            "values": [
                              "Sand",
                              "Olive"
                            ]
                          }
                        ],
                        "reviews": {
                          "count": 12,
                          "average": 4.6
                        }
                      }
                    ],
                    "has_more": true,
                    "next_cursor": "eyJzIjoiY29sbGVjdGlvbiJ9"
                  }
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "not_found",
          "invalid_request",
          "authentication_required",
          "invalid_token",
          "wrong_store",
          "rate_limited"
        ]
      }
    },
    "/categories": {
      "get": {
        "operationId": "sfListCategories",
        "tags": [
          "Collections"
        ],
        "summary": "List categories",
        "description": "The categories present in the catalogue, with product counts. Filter products with `category=<key>`.",
        "responses": {
          "200": {
            "description": "The categories.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CategoryList"
                },
                "example": {
                  "object": "list",
                  "data": [
                    {
                      "object": "category",
                      "key": "dresses",
                      "name": "Dresses",
                      "products_count": 18,
                      "path": "/products?category=dresses"
                    }
                  ],
                  "has_more": false,
                  "next_cursor": null
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "authentication_required",
          "invalid_token",
          "wrong_store",
          "rate_limited"
        ]
      }
    },
    "/pages": {
      "get": {
        "operationId": "sfListPages",
        "tags": [
          "Content"
        ],
        "summary": "List pages",
        "description": "Published content pages and landing pages.",
        "parameters": [
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of pages.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PageList"
                },
                "example": {
                  "object": "list",
                  "data": [
                    {
                      "object": "page",
                      "handle": "about",
                      "title": "About us",
                      "kind": "page",
                      "in_footer": true,
                      "path": "/pages/about",
                      "updated_at": "2026-10-19T23:33:39Z"
                    }
                  ],
                  "has_more": false,
                  "next_cursor": null
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "invalid_request",
          "authentication_required",
          "invalid_token",
          "wrong_store",
          "rate_limited"
        ]
      }
    },
    "/pages/{page}": {
      "get": {
        "operationId": "sfGetPage",
        "tags": [
          "Content"
        ],
        "summary": "Get a page",
        "description": "A published content page with its body (sanitised HTML and plain text).",
        "parameters": [
          {
            "name": "page",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The page's handle."
          }
        ],
        "responses": {
          "200": {
            "description": "The page.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Page"
                },
                "example": {
                  "object": "page",
                  "handle": "about",
                  "title": "About us",
                  "path": "/pages/about",
                  "body_html": "<p>We started in Oran in 2024…</p>",
                  "body_text": "We started in Oran in 2024…",
                  "seo": {
                    "title": "About us",
                    "description": null
                  },
                  "updated_at": "2026-10-19T23:33:39Z"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "not_found",
          "invalid_request",
          "authentication_required",
          "invalid_token",
          "wrong_store",
          "rate_limited"
        ]
      }
    },
    "/policies": {
      "get": {
        "operationId": "sfListPolicies",
        "tags": [
          "Content"
        ],
        "summary": "List policies",
        "description": "The store's published policies.",
        "responses": {
          "200": {
            "description": "The policies.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PolicyList"
                },
                "example": {
                  "object": "list",
                  "data": [
                    {
                      "object": "policy",
                      "kind": "refund",
                      "title": "Returns",
                      "path": "/policies/refund",
                      "updated_at": "2026-10-01T10:00:00Z"
                    }
                  ],
                  "has_more": false,
                  "next_cursor": null
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "authentication_required",
          "invalid_token",
          "wrong_store",
          "rate_limited"
        ]
      }
    },
    "/policies/{kind}": {
      "get": {
        "operationId": "sfGetPolicy",
        "tags": [
          "Content"
        ],
        "summary": "Get a policy",
        "description": "One published policy, its body in Markdown.",
        "parameters": [
          {
            "name": "kind",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The policy kind, as `/policies` lists it."
          }
        ],
        "responses": {
          "200": {
            "description": "The policy.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Policy"
                },
                "example": {
                  "object": "policy",
                  "kind": "refund",
                  "title": "Returns",
                  "path": "/policies/refund",
                  "body_markdown": "You can refuse a parcel at the door, or return it within 7 days…",
                  "updated_at": "2026-10-01T10:00:00Z"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "not_found",
          "invalid_request",
          "authentication_required",
          "invalid_token",
          "wrong_store",
          "rate_limited"
        ]
      }
    },
    "/reviews": {
      "get": {
        "operationId": "sfListReviews",
        "tags": [
          "Reviews and offers"
        ],
        "summary": "List reviews",
        "description": "Published reviews, newest first, the author's first name only. With `product`, also that product's summary.",
        "parameters": [
          {
            "name": "product",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "A product handle, id or `prod_…` id."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 10
            }
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of reviews.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReviewList"
                },
                "example": {
                  "object": "list",
                  "summary": {
                    "count": 12,
                    "average": 4.6
                  },
                  "data": [
                    {
                      "object": "review",
                      "id": "8e2a0f7c-1b3d-4e5f-9a6b-7c8d9e0f1a2b",
                      "product_id": "3f2b1c0e-8d4a-4b7f-9c1e-2a5d6e7f8a90",
                      "rating": 5,
                      "title": "Perfect fit",
                      "body": "Fabric is lovely and delivery was fast.",
                      "author": "Sara",
                      "created_at": "2026-10-28T14:02:00Z"
                    }
                  ],
                  "has_more": true,
                  "next_cursor": "eyJjIjoiMjAyNi0xMC0yOCJ9"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "not_found",
          "invalid_request",
          "authentication_required",
          "invalid_token",
          "wrong_store",
          "rate_limited"
        ]
      }
    },
    "/offers": {
      "get": {
        "operationId": "sfListOffers",
        "tags": [
          "Reviews and offers"
        ],
        "summary": "List live offers",
        "description": "Bundles, quantity tiers, cross-sells and free-delivery offers that are live now — never discount codes. With `product`, only the offers that include it.",
        "parameters": [
          {
            "name": "product",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "A product handle, id or `prod_…` id."
          }
        ],
        "responses": {
          "200": {
            "description": "The offers.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OfferList"
                },
                "example": {
                  "object": "list",
                  "data": [
                    {
                      "object": "offer",
                      "id": "887d61f3-a0a0-45e8-a7cf-8ddfab562822",
                      "type": "bundle",
                      "name": "Dress + scarf",
                      "discount": {
                        "type": "percentage",
                        "value": "10"
                      },
                      "free_shipping": false,
                      "min_quantity": null,
                      "starts_at": null,
                      "ends_at": "2026-11-30T23:59:00Z",
                      "show_countdown": true,
                      "products": [
                        {
                          "product_id": "3f2b1c0e-8d4a-4b7f-9c1e-2a5d6e7f8a90",
                          "handle": "linen-dress",
                          "role": "included"
                        }
                      ],
                      "tiers": []
                    }
                  ],
                  "has_more": false,
                  "next_cursor": null
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "not_found",
          "invalid_request",
          "authentication_required",
          "invalid_token",
          "wrong_store",
          "rate_limited"
        ]
      }
    },
    "/regions": {
      "get": {
        "operationId": "sfListRegions",
        "tags": [
          "Delivery"
        ],
        "summary": "List regions",
        "description": "The regions (wilayas, provinces…) of the store's country, with their codes.",
        "responses": {
          "200": {
            "description": "The regions.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegionList"
                },
                "example": {
                  "object": "list",
                  "country": "DZ",
                  "data": [
                    {
                      "object": "region",
                      "code": "16",
                      "name": "Alger",
                      "name_local": "الجزائر"
                    }
                  ],
                  "has_more": false,
                  "next_cursor": null
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "authentication_required",
          "invalid_token",
          "wrong_store",
          "rate_limited"
        ]
      }
    },
    "/regions/{region}/cities": {
      "get": {
        "operationId": "sfListCities",
        "tags": [
          "Delivery"
        ],
        "summary": "List a region's cities",
        "description": "The cities (communes…) of one region.",
        "parameters": [
          {
            "name": "region",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The region code from `/regions`."
          }
        ],
        "responses": {
          "200": {
            "description": "The cities.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CityList"
                },
                "example": {
                  "object": "list",
                  "country": "DZ",
                  "region": "16",
                  "data": [
                    {
                      "object": "city",
                      "name": "Bab Ezzouar",
                      "name_local": "باب الزوار"
                    }
                  ],
                  "has_more": false,
                  "next_cursor": null
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "not_found",
          "invalid_request",
          "authentication_required",
          "invalid_token",
          "wrong_store",
          "rate_limited"
        ]
      }
    },
    "/delivery": {
      "get": {
        "operationId": "sfGetDelivery",
        "tags": [
          "Delivery"
        ],
        "summary": "Get delivery prices",
        "description": "With `region`, that region's delivery options and prices. Without it,\nevery region's cheapest home and pickup-point price. With `product`,\nthat product's own delivery settings apply. Includes the free-delivery\noffers that could apply.\n",
        "parameters": [
          {
            "name": "region",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "product",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "A product handle, id or `prod_…` id."
          }
        ],
        "responses": {
          "200": {
            "description": "Delivery prices.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeliveryRates"
                },
                "example": {
                  "object": "delivery_rates",
                  "country": "DZ",
                  "region": "16",
                  "delivery_enabled": true,
                  "modes": {
                    "home": true,
                    "pickup_point": true
                  },
                  "options": [
                    {
                      "mode": "home",
                      "label": "Home delivery",
                      "price": {
                        "amount": "600.00",
                        "currency": "DZD"
                      },
                      "courier": "Yalidine"
                    },
                    {
                      "mode": "pickup_point",
                      "label": "Stop desk",
                      "price": {
                        "amount": "400.00",
                        "currency": "DZD"
                      },
                      "courier": "Yalidine"
                    }
                  ],
                  "free_shipping_offers": [
                    {
                      "offer_id": "b152e795-d2c9-4a52-883d-a36214da2d74",
                      "name": "Free delivery from 3",
                      "type": "upsell",
                      "from_quantity": 3
                    }
                  ]
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "not_found",
          "invalid_request",
          "authentication_required",
          "invalid_token",
          "wrong_store",
          "rate_limited"
        ]
      }
    },
    "/cart/price": {
      "post": {
        "operationId": "sfPriceCart",
        "tags": [
          "Cart"
        ],
        "summary": "Price a cart",
        "description": "The server's price for a set of lines — the same calculation an order\ngoes through, so this is exactly what the order will cost. Nothing is\nstored. Add `region` and `delivery_mode` to include delivery. Never\ncached; rate limited more tightly than reads.\n",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CartPriceRequest"
              },
              "example": {
                "lines": [
                  {
                    "variant_id": "52f9c14c-bdae-4b7c-af1f-c04955623056",
                    "quantity": 2
                  }
                ],
                "region": "16",
                "delivery_mode": "home"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The priced cart.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CartPrice"
                },
                "example": {
                  "object": "cart_price",
                  "currency": "DZD",
                  "lines": [
                    {
                      "variant_id": "52f9c14c-bdae-4b7c-af1f-c04955623056",
                      "product_id": "3f2b1c0e-8d4a-4b7f-9c1e-2a5d6e7f8a90",
                      "handle": "linen-dress",
                      "title": "Linen dress",
                      "variant_title": "M / Sand",
                      "image": null,
                      "quantity": 2,
                      "unit_price": {
                        "amount": "4500.00",
                        "currency": "DZD"
                      },
                      "line_total": {
                        "amount": "9000.00",
                        "currency": "DZD"
                      }
                    }
                  ],
                  "offers": [],
                  "subtotal": {
                    "amount": "9000.00",
                    "currency": "DZD"
                  },
                  "discount": {
                    "amount": "0.00",
                    "currency": "DZD"
                  },
                  "shipping": {
                    "amount": "600.00",
                    "currency": "DZD"
                  },
                  "total": {
                    "amount": "9600.00",
                    "currency": "DZD"
                  },
                  "delivery": {
                    "region": "16",
                    "mode": "home",
                    "label": "Home delivery"
                  },
                  "note": null
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-ordexs-errors": [
          "invalid_request",
          "variant_unknown",
          "insufficient_stock",
          "region_unknown",
          "delivery_unavailable",
          "store_closed",
          "authentication_required",
          "invalid_token",
          "wrong_store",
          "rate_limited"
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "StorefrontToken": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Ordexs-Storefront-Token",
        "description": "A public Storefront API token (`ordx_sf_…`), created by the store under\nSettings → Developers → Storefront API. Needed on\n`api.ordexs.com/storefront/v1/<store>`; not needed on the store's own\naddress. Send it in this header only — a token in the query string is\nrefused.\n"
      }
    },
    "parameters": {
      "Query": {
        "name": "q",
        "in": "query",
        "schema": {
          "type": "string",
          "maxLength": 80
        },
        "description": "Search text, matched against product titles."
      },
      "Limit": {
        "name": "limit",
        "in": "query",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "maximum": 100,
          "default": 24
        }
      },
      "Cursor": {
        "name": "cursor",
        "in": "query",
        "schema": {
          "type": "string",
          "maxLength": 400
        },
        "description": "The `next_cursor` of the previous page. Opaque; tied to the filters and sort it came from."
      }
    },
    "responses": {
      "Error": {
        "description": "Something went wrong. `code` is stable; `message` says what to do in plain English.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            },
            "example": {
              "error": {
                "code": "wrong_store",
                "message": "This token belongs to the store \"tulips\". Call https://api.ordexs.com/storefront/v1/tulips/… with it.",
                "request_id": "req_3f9a1c2b4d5e6f708192a3b4c5d6e7f8"
              }
            }
          }
        }
      }
    },
    "examples": {
      "Store": {
        "value": {
          "object": "store",
          "name": "Atelier Nour",
          "handle": "atelier-nour",
          "url": "https://atelier-nour.myordexs.com",
          "logo": "https://cdn.myordexs.com/…/logo-640.webp",
          "language": "ar",
          "direction": "rtl",
          "currency": {
            "code": "DZD",
            "decimals": 2
          },
          "country": "DZ",
          "accepting_orders": true,
          "contact": {
            "email": "hello@atelier-nour.example",
            "phone": "0550 00 00 00",
            "city": "Oran"
          },
          "social": [
            {
              "network": "instagram",
              "label": "Instagram",
              "url": "https://www.instagram.com/ateliernour/"
            }
          ],
          "payment_methods": [
            "cash_on_delivery"
          ]
        }
      },
      "ProductSummary": {
        "value": {
          "object": "product",
          "id": "3f2b1c0e-8d4a-4b7f-9c1e-2a5d6e7f8a90",
          "handle": "linen-dress",
          "title": "Linen dress",
          "path": "/products/linen-dress",
          "price": {
            "min": {
              "amount": "4500.00",
              "currency": "DZD"
            },
            "max": {
              "amount": "4900.00",
              "currency": "DZD"
            }
          },
          "compare_at_price": {
            "amount": "5900.00",
            "currency": "DZD"
          },
          "available": true,
          "image": {
            "url": "https://cdn.myordexs.com/…/linen-dress-1024.webp",
            "alt": "Linen dress"
          },
          "images_count": 5,
          "category": {
            "key": "dresses",
            "name": "Dresses"
          },
          "vendor": "Atelier Nour",
          "tags": [
            "summer"
          ],
          "options": [
            {
              "name": "Size",
              "kind": "size",
              "values": [
                "S",
                "M",
                "L"
              ]
            },
            {
              "name": "Colour",
              "kind": "color",
              "values": [
                "Sand",
                "Olive"
              ]
            }
          ],
          "reviews": {
            "count": 12,
            "average": 4.6
          }
        }
      },
      "Product": {
        "value": {
          "object": "product",
          "id": "3f2b1c0e-8d4a-4b7f-9c1e-2a5d6e7f8a90",
          "handle": "linen-dress",
          "title": "Linen dress",
          "path": "/products/linen-dress",
          "price": {
            "min": {
              "amount": "4500.00",
              "currency": "DZD"
            },
            "max": {
              "amount": "4900.00",
              "currency": "DZD"
            }
          },
          "compare_at_price": {
            "amount": "5900.00",
            "currency": "DZD"
          },
          "available": true,
          "image": {
            "url": "https://cdn.myordexs.com/…/linen-dress-1024.webp",
            "alt": "Linen dress"
          },
          "images_count": 5,
          "category": {
            "key": "dresses",
            "name": "Dresses"
          },
          "vendor": "Atelier Nour",
          "tags": [
            "summer"
          ],
          "options": [
            {
              "name": "Size",
              "kind": "size",
              "values": [
                "S",
                "M",
                "L"
              ]
            }
          ],
          "reviews": {
            "count": 12,
            "average": 4.6
          },
          "description_html": "<p>Breathable linen, cut loose.</p>",
          "description_text": "Breathable linen, cut loose.",
          "product_type": "dress",
          "seo": {
            "title": "Linen dress",
            "description": "Breathable linen, cut loose."
          },
          "images": [
            {
              "url": "https://cdn.myordexs.com/…/linen-dress-1024.webp",
              "alt": "Linen dress"
            }
          ],
          "variants": [
            {
              "object": "variant",
              "id": "52f9c14c-bdae-4b7c-af1f-c04955623056",
              "title": "M",
              "options": {
                "Size": "M"
              },
              "price": {
                "amount": "4500.00",
                "currency": "DZD"
              },
              "compare_at_price": {
                "amount": "5900.00",
                "currency": "DZD"
              },
              "available": true,
              "preorder": false,
              "image": null
            }
          ],
          "collections": [
            {
              "handle": "dresses",
              "title": "Dresses"
            }
          ]
        }
      },
      "CollectionSummary": {
        "value": {
          "object": "collection",
          "id": "6318d68d-8aef-4ae1-8e6c-578576a38551",
          "handle": "dresses",
          "title": "Dresses",
          "path": "/collections/dresses",
          "description_text": "Light dresses for warm days.",
          "image": "https://cdn.myordexs.com/…/dresses-1024.webp",
          "products_count": 18
        }
      }
    },
    "schemas": {
      "Money": {
        "type": "object",
        "required": [
          "amount",
          "currency"
        ],
        "properties": {
          "amount": {
            "type": "string",
            "description": "A decimal string with the currency's own decimals."
          },
          "currency": {
            "type": "string",
            "description": "ISO 4217 code."
          }
        }
      },
      "MoneyRange": {
        "type": "object",
        "properties": {
          "min": {
            "$ref": "#/components/schemas/Money"
          },
          "max": {
            "$ref": "#/components/schemas/Money"
          }
        }
      },
      "Image": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "alt": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "Error": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "code",
              "message"
            ],
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string",
                "description": "On the developer host. Quote it to support."
              }
            }
          }
        }
      },
      "ListMeta": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "const": "list"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "Store": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "const": "store"
          },
          "name": {
            "type": "string"
          },
          "handle": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "logo": {
            "type": [
              "string",
              "null"
            ]
          },
          "language": {
            "type": "string"
          },
          "direction": {
            "type": "string",
            "enum": [
              "ltr",
              "rtl"
            ]
          },
          "currency": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "decimals": {
                "type": "integer"
              }
            }
          },
          "country": {
            "type": [
              "string",
              "null"
            ]
          },
          "accepting_orders": {
            "type": "boolean"
          },
          "contact": {
            "type": "object",
            "properties": {
              "email": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "phone": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "city": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "social": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "network": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                }
              }
            }
          },
          "payment_methods": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "NavItem": {
        "type": "object",
        "properties": {
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "kind": {
            "type": "string",
            "enum": [
              "catalog",
              "collection",
              "page",
              "landing_page",
              "policy"
            ]
          },
          "handle": {
            "type": "string"
          },
          "path": {
            "type": "string"
          }
        }
      },
      "Navigation": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "const": "navigation"
          },
          "main": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/NavItem"
            }
          },
          "footer": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/NavItem"
            }
          }
        }
      },
      "ProductSummary": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "const": "product"
          },
          "id": {
            "type": "string"
          },
          "handle": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "path": {
            "type": "string",
            "description": "The product's path on the store's address."
          },
          "price": {
            "$ref": "#/components/schemas/MoneyRange"
          },
          "compare_at_price": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ]
          },
          "available": {
            "type": "boolean"
          },
          "image": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Image"
              },
              {
                "type": "null"
              }
            ]
          },
          "images_count": {
            "type": "integer"
          },
          "category": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "key": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            }
          },
          "vendor": {
            "type": [
              "string",
              "null"
            ]
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "options": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "kind": {
                  "type": "string"
                },
                "values": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "reviews": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer"
              },
              "average": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          }
        }
      },
      "Variant": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "const": "variant"
          },
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "options": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "price": {
            "$ref": "#/components/schemas/Money"
          },
          "compare_at_price": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ]
          },
          "available": {
            "type": "boolean",
            "description": "Can be ordered now. Exact stock is never shown."
          },
          "preorder": {
            "type": "boolean"
          },
          "image": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "Product": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ProductSummary"
          },
          {
            "type": "object",
            "properties": {
              "description_html": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Sanitised HTML."
              },
              "description_text": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "product_type": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "seo": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string"
                  },
                  "description": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                }
              },
              "images": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Image"
                }
              },
              "variants": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Variant"
                }
              },
              "collections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "handle": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        ]
      },
      "ProductList": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ListMeta"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/ProductSummary"
                }
              }
            }
          }
        ]
      },
      "Facets": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "const": "facets"
          },
          "products": {
            "type": "integer"
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "key": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "count": {
                  "type": "integer"
                }
              }
            }
          },
          "vendors": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string"
                },
                "count": {
                  "type": "integer"
                }
              }
            }
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string"
                },
                "count": {
                  "type": "integer"
                }
              }
            }
          },
          "price": {
            "$ref": "#/components/schemas/MoneyRange"
          },
          "options": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "values": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "value": {
                        "type": "string"
                      },
                      "count": {
                        "type": "integer"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "Suggestions": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "const": "suggestions"
          },
          "query": {
            "type": "string"
          },
          "products": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "collections": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "handle": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "path": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "CollectionSummary": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "const": "collection"
          },
          "id": {
            "type": "string"
          },
          "handle": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "description_text": {
            "type": [
              "string",
              "null"
            ]
          },
          "image": {
            "type": [
              "string",
              "null"
            ]
          },
          "products_count": {
            "type": "integer"
          }
        }
      },
      "Collection": {
        "allOf": [
          {
            "$ref": "#/components/schemas/CollectionSummary"
          },
          {
            "type": "object",
            "properties": {
              "description_html": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "seo": {
                "type": "object"
              },
              "products": {
                "$ref": "#/components/schemas/ProductList"
              }
            }
          }
        ]
      },
      "CollectionList": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ListMeta"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/CollectionSummary"
                }
              }
            }
          }
        ]
      },
      "CategoryList": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ListMeta"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "object": {
                      "type": "string",
                      "const": "category"
                    },
                    "key": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "products_count": {
                      "type": "integer"
                    },
                    "path": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        ]
      },
      "PageList": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ListMeta"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "object": {
                      "type": "string",
                      "const": "page"
                    },
                    "handle": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "kind": {
                      "type": "string",
                      "enum": [
                        "page",
                        "landing_page"
                      ]
                    },
                    "in_footer": {
                      "type": "boolean"
                    },
                    "path": {
                      "type": "string"
                    },
                    "updated_at": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        ]
      },
      "Page": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "const": "page"
          },
          "handle": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "kind": {
            "type": "string",
            "enum": [
              "page",
              "landing_page"
            ],
            "description": "A landing page is built from blocks: its body is usually null; open it at its path."
          },
          "path": {
            "type": "string"
          },
          "body_html": {
            "type": [
              "string",
              "null"
            ]
          },
          "body_text": {
            "type": [
              "string",
              "null"
            ]
          },
          "seo": {
            "type": "object"
          },
          "updated_at": {
            "type": "string"
          }
        }
      },
      "PolicyList": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ListMeta"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "object": {
                      "type": "string",
                      "const": "policy"
                    },
                    "kind": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "path": {
                      "type": "string"
                    },
                    "updated_at": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        ]
      },
      "Policy": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "const": "policy"
          },
          "kind": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "body_markdown": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          }
        }
      },
      "ReviewList": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ListMeta"
          },
          {
            "type": "object",
            "properties": {
              "summary": {
                "type": "object",
                "properties": {
                  "count": {
                    "type": "integer"
                  },
                  "average": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                }
              },
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "object": {
                      "type": "string",
                      "const": "review"
                    },
                    "id": {
                      "type": "string"
                    },
                    "product_id": {
                      "type": "string"
                    },
                    "rating": {
                      "type": "integer"
                    },
                    "title": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "body": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "author": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "First name only."
                    },
                    "created_at": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        ]
      },
      "OfferList": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ListMeta"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "object": {
                      "type": "string",
                      "const": "offer"
                    },
                    "id": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string",
                      "description": "bundle, upsell (quantity tiers), cross_sell, …"
                    },
                    "name": {
                      "type": "string"
                    },
                    "discount": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "percentage",
                            "fixed"
                          ]
                        },
                        "value": {
                          "type": "string"
                        }
                      }
                    },
                    "free_shipping": {
                      "type": "boolean"
                    },
                    "min_quantity": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "starts_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ends_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "show_countdown": {
                      "type": "boolean"
                    },
                    "products": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "product_id": {
                            "type": "string"
                          },
                          "handle": {
                            "type": "string"
                          },
                          "role": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "tiers": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "quantity": {
                            "type": "integer"
                          },
                          "discount": {
                            "type": [
                              "object",
                              "null"
                            ]
                          },
                          "free_shipping": {
                            "type": "boolean"
                          },
                          "label": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "badge": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        ]
      },
      "RegionList": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ListMeta"
          },
          {
            "type": "object",
            "properties": {
              "country": {
                "type": "string"
              },
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "object": {
                      "type": "string",
                      "const": "region"
                    },
                    "code": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "name_local": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                }
              }
            }
          }
        ]
      },
      "CityList": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ListMeta"
          },
          {
            "type": "object",
            "properties": {
              "country": {
                "type": "string"
              },
              "region": {
                "type": "string"
              },
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "object": {
                      "type": "string",
                      "const": "city"
                    },
                    "name": {
                      "type": "string"
                    },
                    "name_local": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                }
              }
            }
          }
        ]
      },
      "DeliveryRates": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "const": "delivery_rates"
          },
          "country": {
            "type": "string"
          },
          "region": {
            "type": [
              "string",
              "null"
            ]
          },
          "delivery_enabled": {
            "type": "boolean"
          },
          "modes": {
            "type": "object",
            "properties": {
              "home": {
                "type": "boolean"
              },
              "pickup_point": {
                "type": "boolean"
              }
            }
          },
          "options": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "mode": {
                  "type": "string",
                  "enum": [
                    "home",
                    "pickup_point"
                  ]
                },
                "label": {
                  "type": "string"
                },
                "price": {
                  "$ref": "#/components/schemas/Money"
                },
                "courier": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          },
          "free_shipping_offers": {
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        }
      },
      "CartPriceRequest": {
        "type": "object",
        "required": [
          "lines"
        ],
        "properties": {
          "lines": {
            "type": "array",
            "minItems": 1,
            "maxItems": 50,
            "items": {
              "type": "object",
              "required": [
                "variant_id",
                "quantity"
              ],
              "properties": {
                "variant_id": {
                  "type": "string",
                  "description": "A variant id or `var_…` id."
                },
                "quantity": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 99
                }
              }
            }
          },
          "region": {
            "type": "string",
            "description": "A region code from `/regions`. With `delivery_mode`, adds delivery."
          },
          "delivery_mode": {
            "type": "string",
            "enum": [
              "home",
              "pickup_point"
            ]
          },
          "offer_ids": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string"
            },
            "description": "Offers the shopper picked (e.g. a bundle). Discount codes are not accepted here."
          }
        }
      },
      "CartPrice": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "const": "cart_price"
          },
          "currency": {
            "type": "string"
          },
          "lines": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "offers": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "subtotal": {
            "$ref": "#/components/schemas/Money"
          },
          "discount": {
            "$ref": "#/components/schemas/Money"
          },
          "shipping": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ]
          },
          "total": {
            "$ref": "#/components/schemas/Money"
          },
          "delivery": {
            "type": [
              "object",
              "null"
            ]
          },
          "note": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    }
  }
}