{
  "openapi": "3.1.0",
  "info": {
    "title": "Phoenix Putter Co Storefront API",
    "summary": "Read-only catalog data and agent-driven commerce for phoenixputterco.com.",
    "description": "Machine-readable description of the public API surface of the Phoenix Putter Co storefront, a Shopify store. There are two ways for an agent to work with this store. (1) Read-only catalog endpoints: GET /products.json, GET /products/{handle}.json, GET /collections/{handle}/products.json and GET /search/suggest.json. These need no authentication, no credentials and no scopes. (2) Universal Commerce Protocol (UCP) over MCP at POST /api/ucp/mcp, used for catalog search, cart and checkout; capabilities are advertised at GET /.well-known/ucp. Discovery methods on that endpoint are open, but tools/call requires a signed agent JWT and an agent profile URI. Checkout requires contemporaneous human approval: agents must not complete payment autonomously. See https://phoenixputterco.com/agents.md and https://phoenixputterco.com/robots.txt for the full agent policy. Every failure on this API surface is returned as JSON with a machine-readable code, a message and a resolution hint; see x-error-handling and the Error, InvalidParameterError and JsonRpcError schemas.",
    "version": "2026-08-21",
    "termsOfService": "https://phoenixputterco.com/policies/terms-of-service",
    "contact": {
      "name": "Phoenix Putter Co",
      "email": "info@phoenixputterco.com",
      "url": "https://phoenixputterco.com/pages/contact"
    },
    "license": {
      "name": "Store Terms of Service",
      "url": "https://phoenixputterco.com/policies/terms-of-service"
    }
  },
  "externalDocs": {
    "description": "Agent instructions for this store",
    "url": "https://phoenixputterco.com/agents.md"
  },
  "servers": [
    { "url": "https://phoenixputterco.com", "description": "Primary storefront domain" },
    { "url": "https://phoenix-putter-co.myshopify.com", "description": "Canonical Shopify domain" }
  ],
  "x-agent-policy": {
    "checkout_requires_human_approval": true,
    "automated_payment_prohibited": true,
    "preferred_transaction_path": "https://phoenixputterco.com/api/ucp/mcp",
    "agent_instructions": "https://phoenixputterco.com/agents.md",
    "llms_txt": "https://phoenixputterco.com/llms.txt",
    "robots_txt": "https://phoenixputterco.com/robots.txt",
    "rate_limit_policy": "The UCP/MCP endpoint is rate limited per IP. Back off on HTTP 429."
  },
  "x-error-handling": {
    "summary": "Every machine endpoint on this store answers failures with JSON, never with an HTML error page.",
    "catalog_endpoints": {
      "400": "Invalid pagination. Body: {\"errors\": \"Page * Limit exceeds the 25000 limit.\"}",
      "404": "Unknown product handle. Content-Type application/json with an empty body. Resolve the correct handle from /sitemap.xml or /search/suggest.json.",
      "422": "Missing or empty required parameter. Body: {\"status\": 422, \"message\": \"Invalid parameter error\", \"description\": \"param is missing or the value is empty: q\"}",
      "note": "An unknown collection handle on /collections/{handle}/products.json returns HTTP 200 with an empty products array rather than a 404. Check products.length, not the status code."
    },
    "ucp_mcp_endpoint": {
      "400": "Malformed request body. JSON-RPC error -32600 Invalid Request.",
      "403": "JSON-RPC error -32000 AuthenticationRequired. data carries the resolution hint, including the URL of the agent authentication documentation.",
      "422": "JSON-RPC error -32001 UCP discovery failed, data.code invalid_profile_url, data.continue_url points at a recoverable entry point."
    },
    "html_pages": {
      "404": "HTML pages return a real HTTP 404 (never a 200 with an app shell). The 404 body carries a short markdown recovery document in <script type=\"text/markdown\" data-agent-recovery=\"404\"> and a structured error object matching the Error schema in <script type=\"application/json\" data-agent-error=\"404\">."
    }
  },
  "tags": [
    { "name": "discovery", "description": "Machine-readable descriptions of this store." },
    { "name": "catalog", "description": "Read-only product and collection data. No authentication required." },
    { "name": "commerce", "description": "Cart and checkout via the Universal Commerce Protocol. Payment requires buyer approval." }
  ],
  "security": [],
  "paths": {
    "/openapi.json": {
      "get": {
        "tags": ["discovery"],
        "operationId": "getOpenApiSpec",
        "summary": "This document",
        "description": "Returns this OpenAPI 3.1 description of the storefront API surface. The request is 301-redirected to /pages/openapi, which is where the document is rendered.",
        "security": [],
        "responses": {
          "200": {
            "description": "OpenAPI document",
            "content": { "application/json": { "schema": { "type": "object" } } }
          }
        }
      }
    },
    "/.well-known/ucp": {
      "get": {
        "tags": ["discovery", "commerce"],
        "operationId": "getUcpProfile",
        "summary": "UCP merchant profile",
        "description": "Returns the store Universal Commerce Protocol profile: supported protocol versions, service endpoints, capabilities and payment handlers. Start here before calling the MCP endpoint.",
        "security": [],
        "responses": {
          "200": {
            "description": "UCP merchant profile",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["ucp"],
                  "properties": {
                    "ucp": {
                      "type": "object",
                      "properties": {
                        "version": { "type": "string", "examples": ["2026-04-08"] },
                        "supported_versions": { "type": "object", "additionalProperties": { "type": "string", "format": "uri" } },
                        "services": { "type": "object" },
                        "capabilities": { "type": "object" },
                        "payment_handlers": { "type": "object" }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/agents.md": {
      "get": {
        "tags": ["discovery"],
        "operationId": "getAgentInstructions",
        "summary": "Agent instructions (markdown)",
        "security": [],
        "responses": {
          "200": {
            "description": "Agent instructions",
            "content": { "text/markdown": { "schema": { "type": "string" } } }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "tags": ["discovery"],
        "operationId": "getLlmsTxt",
        "summary": "LLM-oriented site guide (markdown)",
        "security": [],
        "responses": {
          "200": {
            "description": "llms.txt guide",
            "content": { "text/markdown": { "schema": { "type": "string" } } }
          }
        }
      }
    },
    "/sitemap.xml": {
      "get": {
        "tags": ["discovery"],
        "operationId": "getSitemapIndex",
        "summary": "Sitemap index",
        "security": [],
        "responses": {
          "200": {
            "description": "XML sitemap index",
            "content": { "application/xml": { "schema": { "type": "string" } } }
          }
        }
      }
    },
    "/products.json": {
      "get": {
        "tags": ["catalog"],
        "operationId": "listProducts",
        "summary": "List published products",
        "description": "Paginated list of every product published to the online store. Public and unauthenticated. page multiplied by limit must not exceed 25000.",
        "security": [],
        "parameters": [
          { "$ref": "#/components/parameters/Limit" },
          { "$ref": "#/components/parameters/Page" }
        ],
        "responses": {
          "200": {
            "description": "A page of products. An out-of-range page within the pagination ceiling returns an empty products array.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["products"],
                  "properties": {
                    "products": { "type": "array", "items": { "$ref": "#/components/schemas/Product" } }
                  }
                }
              }
            }
          },
          "400": { "$ref": "#/components/responses/BadPagination" },
          "429": { "$ref": "#/components/responses/RateLimited" }
        }
      }
    },
    "/products/{handle}.json": {
      "get": {
        "tags": ["catalog"],
        "operationId": "getProduct",
        "summary": "Get one product by handle",
        "security": [],
        "parameters": [{ "$ref": "#/components/parameters/ProductHandle" }],
        "responses": {
          "200": {
            "description": "The product",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["product"],
                  "properties": { "product": { "$ref": "#/components/schemas/Product" } }
                }
              }
            }
          },
          "404": { "$ref": "#/components/responses/ProductNotFound" },
          "429": { "$ref": "#/components/responses/RateLimited" }
        }
      }
    },
    "/collections/{handle}/products.json": {
      "get": {
        "tags": ["catalog"],
        "operationId": "listCollectionProducts",
        "summary": "List products in a collection",
        "description": "Products in a collection. An unknown collection handle returns HTTP 200 with an empty products array rather than a 404, so test products.length rather than the status code.",
        "security": [],
        "x-unknown-handle-behavior": "200 with an empty products array",
        "parameters": [
          { "$ref": "#/components/parameters/CollectionHandle" },
          { "$ref": "#/components/parameters/Limit" },
          { "$ref": "#/components/parameters/Page" }
        ],
        "responses": {
          "200": {
            "description": "A page of products in the collection, empty if the handle does not exist",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["products"],
                  "properties": {
                    "products": { "type": "array", "items": { "$ref": "#/components/schemas/Product" } }
                  }
                }
              }
            }
          },
          "400": { "$ref": "#/components/responses/BadPagination" },
          "429": { "$ref": "#/components/responses/RateLimited" }
        }
      }
    },
    "/search/suggest.json": {
      "get": {
        "tags": ["catalog"],
        "operationId": "searchSuggest",
        "summary": "Predictive search across products, collections, pages and articles",
        "description": "Use this to resolve a buyer's words into product handles before calling any other endpoint. q is required; omitting it returns a structured 422.",
        "security": [],
        "parameters": [
          { "name": "q", "in": "query", "required": true, "description": "Search terms.", "schema": { "type": "string", "minLength": 1 } },
          { "name": "resources[type]", "in": "query", "required": false, "description": "Comma-separated resource types to search.", "schema": { "type": "string", "default": "product", "examples": ["product,collection,article,page"] } },
          { "name": "resources[limit]", "in": "query", "required": false, "description": "Results per resource type, 1 to 10.", "schema": { "type": "integer", "minimum": 1, "maximum": 10, "default": 10 } }
        ],
        "responses": {
          "200": {
            "description": "Suggestion results",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["resources"],
                  "properties": {
                    "resources": {
                      "type": "object",
                      "properties": {
                        "results": {
                          "type": "object",
                          "properties": {
                            "products": { "type": "array", "items": { "$ref": "#/components/schemas/Product" } },
                            "collections": { "type": "array", "items": { "type": "object" } },
                            "pages": { "type": "array", "items": { "type": "object" } },
                            "articles": { "type": "array", "items": { "type": "object" } }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "422": { "$ref": "#/components/responses/InvalidParameter" },
          "429": { "$ref": "#/components/responses/RateLimited" }
        }
      }
    },
    "/api/ucp/mcp": {
      "post": {
        "tags": ["commerce"],
        "operationId": "ucpMcp",
        "summary": "Universal Commerce Protocol endpoint (MCP over JSON-RPC 2.0)",
        "description": "Agent-facing commerce endpoint. Call initialize, then tools/list to discover tool schemas, then tools/call. Available tools: search_catalog, lookup_catalog, get_product, create_cart, get_cart, update_cart, cancel_cart, create_checkout, get_checkout, update_checkout, complete_checkout, cancel_checkout, get_order. initialize and tools/list are open. tools/call is scoped twice over: the caller must present a signed agent JWT as a bearer token, and must identify itself by passing params.arguments.meta['ucp-agent'].profile, a URI resolving to its agent profile document. Omitting the JWT returns -32000 AuthenticationRequired; omitting the profile returns -32001 with data.code invalid_profile_url. complete_checkout finalizes payment and must not be called without explicit, contemporaneous buyer approval.",
        "security": [{}, { "ucpAgentJwt": [] }],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": { "$ref": "#/components/schemas/JsonRpcRequest" },
              "examples": {
                "toolsList": {
                  "summary": "Discover available tools (no authentication required)",
                  "value": { "jsonrpc": "2.0", "id": 1, "method": "tools/list" }
                },
                "searchCatalog": {
                  "summary": "Search the catalog (requires agent JWT and profile)",
                  "value": {
                    "jsonrpc": "2.0",
                    "id": 2,
                    "method": "tools/call",
                    "params": {
                      "name": "search_catalog",
                      "arguments": {
                        "query": "milled blade putter",
                        "meta": { "ucp-agent": { "profile": "https://agent.example/profiles/shopping-agent.json" } }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "JSON-RPC result.",
            "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonRpcResponse" } } }
          },
          "400": {
            "description": "Malformed request body.",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/JsonRpcErrorResponse" },
                "examples": {
                  "invalidRequest": {
                    "summary": "Body was not valid JSON",
                    "value": { "jsonrpc": "2.0", "id": 0, "error": { "code": -32600, "message": "Invalid Request", "data": "Invalid JSON in request body." } }
                  }
                }
              }
            }
          },
          "403": {
            "description": "The tool call requires a signed agent JWT.",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/JsonRpcErrorResponse" },
                "examples": {
                  "authenticationRequired": {
                    "summary": "Bearer token missing",
                    "value": { "jsonrpc": "2.0", "id": 9, "error": { "code": -32000, "message": "AuthenticationRequired", "data": "Unauthorized: A valid JWT is required. See https://shopify.dev/docs/agents/get-started/authentication" } }
                  }
                }
              }
            }
          },
          "422": {
            "description": "The request was well-formed JSON-RPC but could not be processed, for example a missing or unresolvable agent profile URI.",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/JsonRpcErrorResponse" },
                "examples": {
                  "missingProfile": {
                    "summary": "Agent profile URI missing",
                    "value": {
                      "jsonrpc": "2.0",
                      "id": 1,
                      "error": {
                        "code": -32001,
                        "message": "UCP discovery failed",
                        "data": {
                          "code": "invalid_profile_url",
                          "content": "Unable to fetch agent profile: Missing profile uri",
                          "continue_url": "https://phoenixputterco.com/"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": { "$ref": "#/components/responses/RateLimited" }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "Limit": {
        "name": "limit",
        "in": "query",
        "required": false,
        "description": "Number of products to return per page.",
        "schema": { "type": "integer", "minimum": 1, "maximum": 250, "default": 30 }
      },
      "Page": {
        "name": "page",
        "in": "query",
        "required": false,
        "description": "1-based page number. page multiplied by limit must not exceed 25000.",
        "schema": { "type": "integer", "minimum": 1, "default": 1 }
      },
      "ProductHandle": {
        "name": "handle",
        "in": "path",
        "required": true,
        "description": "Product handle, for example origin-blade-putter.",
        "schema": { "type": "string", "pattern": "^[a-z0-9-]+$" }
      },
      "CollectionHandle": {
        "name": "handle",
        "in": "path",
        "required": true,
        "description": "Collection handle, for example all or custom-personalized-golf-putters.",
        "schema": { "type": "string", "pattern": "^[a-z0-9-]+$" }
      }
    },
    "responses": {
      "ProductNotFound": {
        "description": "No product exists with that handle. A real HTTP 404 is returned with Content-Type application/json and an empty body; this store never answers an unknown path with a 200 carrying an app shell. Resolve the correct handle from /sitemap.xml or GET /search/suggest.json, or read /agents.md for the full agent surface.",
        "content": { "application/json": { "schema": { "type": "string", "maxLength": 0, "description": "Empty body." } } }
      },
      "BadPagination": {
        "description": "Pagination out of bounds.",
        "content": {
          "application/json": {
            "schema": { "$ref": "#/components/schemas/LegacyErrorEnvelope" },
            "examples": {
              "paginationCeiling": {
                "summary": "page multiplied by limit exceeds the ceiling",
                "value": { "errors": "Page * Limit exceeds the 25000 limit." }
              }
            }
          }
        }
      },
      "InvalidParameter": {
        "description": "A required query parameter was missing or empty.",
        "content": {
          "application/json": {
            "schema": { "$ref": "#/components/schemas/InvalidParameterError" },
            "examples": {
              "missingQ": {
                "summary": "q was not supplied",
                "value": { "status": 422, "message": "Invalid parameter error", "description": "param is missing or the value is empty: q" }
              }
            }
          }
        }
      },
      "RateLimited": {
        "description": "Too many requests. Back off and retry.",
        "content": {
          "application/json": {
            "schema": { "$ref": "#/components/schemas/Error" },
            "examples": {
              "rateLimited": {
                "value": {
                  "error": {
                    "code": "rate_limited",
                    "status": 429,
                    "message": "Request rate exceeded.",
                    "hints": ["Honor the Retry-After header", "Reduce concurrency"],
                    "documentation_url": "https://phoenixputterco.com/openapi.json"
                  }
                }
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "ucpAgentJwt": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "Signed agent JWT required by tools/call on the UCP MCP endpoint. Discovery methods (initialize, tools/list) do not require it. The token identifies the calling agent and is scoped to the commerce tools it is permitted to invoke; payment-completing tools additionally require contemporaneous buyer approval. See https://shopify.dev/docs/agents/get-started/authentication.",
        "x-additional-identity-requirement": "params.arguments.meta['ucp-agent'].profile must be a resolvable URI describing the calling agent."
      },
      "storefrontAccessToken": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Shopify-Storefront-Access-Token",
        "description": "Scoped, read-mostly token for the Shopify Storefront GraphQL API. Scopes are granted per token and enforced by Shopify; request only what you need.",
        "x-scopes": {
          "unauthenticated_read_product_listings": "Read products and collections",
          "unauthenticated_read_product_inventory": "Read inventory levels",
          "unauthenticated_read_product_tags": "Read product tags",
          "unauthenticated_read_content": "Read pages, blogs and articles",
          "unauthenticated_read_selling_plans": "Read subscription selling plans",
          "unauthenticated_read_checkouts": "Read carts and checkouts created by this token",
          "unauthenticated_write_checkouts": "Create and update carts and checkouts",
          "unauthenticated_read_customers": "Read the authenticated customer",
          "unauthenticated_write_customers": "Update the authenticated customer"
        },
        "x-least-privilege": "Catalog-only agents should hold nothing beyond unauthenticated_read_product_listings and unauthenticated_read_content."
      },
      "customerAccountOAuth": {
        "type": "oauth2",
        "description": "OAuth 2.0 with PKCE (S256) for customer-scoped access via the Shopify Customer Account API. Endpoints are discoverable at https://shopify.com/authentication/55530389782/.well-known/openid-configuration. Tokens are issued per scope and enforced by Shopify.",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://shopify.com/authentication/55530389782/oauth/authorize",
            "tokenUrl": "https://shopify.com/authentication/55530389782/oauth/token",
            "refreshUrl": "https://shopify.com/authentication/55530389782/oauth/token",
            "scopes": {
              "openid": "Authenticate the customer and issue an ID token",
              "email": "Read the customer email address",
              "customer-account-api:full": "Read and manage the signed-in customer's own account, addresses and orders",
              "customer-account-mcp-api:full": "Access the customer account MCP surface on the signed-in customer's behalf"
            }
          }
        }
      },
      "adminApiOAuth": {
        "type": "oauth2",
        "description": "OAuth 2.0 for back-office integrations against the Shopify Admin API. Access is granted per scope at install time and enforced by Shopify; an integration can never exceed the scopes it was granted. Read-only integrations must not request write scopes.",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://phoenix-putter-co.myshopify.com/admin/oauth/authorize",
            "tokenUrl": "https://phoenix-putter-co.myshopify.com/admin/oauth/access_token",
            "scopes": {
              "read_products": "Read products, variants and collections",
              "read_inventory": "Read inventory levels",
              "read_orders": "Read orders",
              "write_orders": "Create and update orders",
              "read_customers": "Read customer records",
              "read_content": "Read pages, blogs and articles",
              "read_themes": "Read theme files"
            }
          }
        }
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "description": "Structured error envelope used by this store's own error surfaces, including the machine-readable error object embedded in HTML 404 pages.",
        "required": ["error"],
        "properties": {
          "error": {
            "type": "object",
            "required": ["code", "status", "message"],
            "properties": {
              "code": {
                "type": "string",
                "description": "Stable, machine-readable error code.",
                "enum": ["not_found", "gone", "bad_request", "unauthorized", "forbidden", "rate_limited", "server_error"]
              },
              "status": { "type": "integer", "description": "HTTP status code.", "examples": [404] },
              "message": { "type": "string", "description": "Human-readable explanation." },
              "hints": {
                "type": "array",
                "description": "Concrete next steps an agent can take to recover.",
                "items": { "type": "string" }
              },
              "documentation_url": { "type": "string", "format": "uri" }
            }
          }
        }
      },
      "InvalidParameterError": {
        "type": "object",
        "description": "Returned by Shopify storefront JSON endpoints when a required query parameter is missing or empty.",
        "required": ["status", "message"],
        "properties": {
          "status": { "type": "integer", "examples": [422] },
          "message": { "type": "string", "examples": ["Invalid parameter error"] },
          "description": { "type": "string", "description": "Which parameter failed and why.", "examples": ["param is missing or the value is empty: q"] }
        }
      },
      "LegacyErrorEnvelope": {
        "type": "object",
        "description": "Compact error envelope used by the paginated storefront JSON endpoints.",
        "required": ["errors"],
        "properties": {
          "errors": { "type": ["string", "array", "object"], "description": "Error message or messages." }
        }
      },
      "JsonRpcRequest": {
        "type": "object",
        "required": ["jsonrpc", "method"],
        "properties": {
          "jsonrpc": { "type": "string", "const": "2.0" },
          "id": { "type": ["string", "integer"] },
          "method": { "type": "string", "examples": ["initialize", "tools/list", "tools/call"] },
          "params": { "type": "object" }
        }
      },
      "JsonRpcResponse": {
        "type": "object",
        "required": ["jsonrpc"],
        "properties": {
          "jsonrpc": { "type": "string", "const": "2.0" },
          "id": { "type": ["string", "integer", "null"] },
          "result": { "type": "object" },
          "error": { "$ref": "#/components/schemas/JsonRpcError" }
        }
      },
      "JsonRpcErrorResponse": {
        "type": "object",
        "required": ["jsonrpc", "error"],
        "properties": {
          "jsonrpc": { "type": "string", "const": "2.0" },
          "id": { "type": ["string", "integer", "null"] },
          "error": { "$ref": "#/components/schemas/JsonRpcError" }
        }
      },
      "JsonRpcError": {
        "type": "object",
        "required": ["code", "message"],
        "properties": {
          "code": { "type": "integer", "description": "JSON-RPC error code. -32600 malformed request, -32000 authentication required, -32001 UCP discovery failed.", "examples": [-32600, -32000, -32001] },
          "message": { "type": "string" },
          "data": {
            "description": "Additional detail. A string for transport-level errors, or an object carrying a machine-readable code and a recovery URL.",
            "type": ["string", "object"],
            "properties": {
              "code": { "type": "string", "examples": ["invalid_profile_url"] },
              "content": { "type": "string" },
              "continue_url": { "type": "string", "format": "uri" }
            }
          }
        }
      },
      "Product": {
        "type": "object",
        "properties": {
          "id": { "type": "integer" },
          "title": { "type": "string" },
          "handle": { "type": "string" },
          "body_html": { "type": "string" },
          "published_at": { "type": "string", "format": "date-time" },
          "created_at": { "type": "string", "format": "date-time" },
          "updated_at": { "type": "string", "format": "date-time" },
          "vendor": { "type": "string" },
          "product_type": { "type": "string" },
          "tags": { "type": "array", "items": { "type": "string" } },
          "variants": { "type": "array", "items": { "$ref": "#/components/schemas/Variant" } },
          "images": { "type": "array", "items": { "$ref": "#/components/schemas/Image" } },
          "options": { "type": "array", "items": { "type": "object" } }
        }
      },
      "Variant": {
        "type": "object",
        "properties": {
          "id": { "type": "integer" },
          "title": { "type": "string" },
          "sku": { "type": "string" },
          "price": { "type": "string", "description": "Price as a decimal string in the shop currency (USD)." },
          "available": { "type": "boolean" },
          "requires_shipping": { "type": "boolean" },
          "taxable": { "type": "boolean" },
          "grams": { "type": "integer" }
        }
      },
      "Image": {
        "type": "object",
        "properties": {
          "id": { "type": "integer" },
          "src": { "type": "string", "format": "uri" },
          "width": { "type": "integer" },
          "height": { "type": "integer" },
          "alt": { "type": ["string", "null"] }
        }
      }
    }
  }
}