{"openapi":"3.1.0","info":{"title":"Coffee Mug GPT Public Product API","version":"2026-07-21","description":"Read-only product discovery for Coffee Mug GPT. This API cannot upload artwork, create a design, start checkout, charge a payment method, or place an order."},"servers":[{"url":"https://coffeemuggpt.com"}],"paths":{"/api/products":{"get":{"operationId":"getProductOptions","summary":"Get exact mug variants and artwork requirements","description":"Returns supported mug variants, prices, print dimensions, upload limits, stable variant URLs, and the current operational orderability state.","responses":{"200":{"description":"The public mug catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductCatalog"}}}}}}}},"components":{"schemas":{"Money":{"type":"object","required":["currency","amount","amount_minor"],"properties":{"currency":{"type":"string","const":"USD"},"amount":{"type":"string","pattern":"^[0-9]+\\.[0-9]{2}$"},"amount_minor":{"type":"integer","minimum":0}}},"ProductVariant":{"type":"object","required":["variant_id","fulfillment_catalog_variant_id","name","exterior_color","finish","capacity_fl_oz","variant_url","upload_artwork_url","orderability","stock_status","print_area","artwork"],"properties":{"variant_id":{"type":"string"},"fulfillment_catalog_variant_id":{"type":"integer"},"name":{"type":"string"},"exterior_color":{"type":"string","enum":["white","black"]},"finish":{"type":"string","const":"glossy"},"capacity_fl_oz":{"type":"integer"},"variant_url":{"type":"string","format":"uri"},"upload_artwork_url":{"type":"string","format":"uri"},"orderability":{"type":"string","enum":["available","temporarily_unavailable"]},"stock_status":{"type":"string","const":"not_checked_by_this_endpoint"},"print_area":{"type":"object","required":["width_px","height_px","dpi"],"properties":{"width_px":{"type":"integer"},"height_px":{"type":"integer"},"dpi":{"type":"integer"}}},"artwork":{"type":"object","required":["minimum_width_px","minimum_height_px","recommended_width_px","recommended_height_px"],"properties":{"minimum_width_px":{"type":"integer"},"minimum_height_px":{"type":"integer"},"recommended_width_px":{"type":"integer"},"recommended_height_px":{"type":"integer"}}}}},"ProductCatalog":{"type":"object","required":["schema_version","merchant","capabilities","product_group","purchase_options","variants","artwork_upload_requirements","links"],"properties":{"schema_version":{"type":"string"},"merchant":{"type":"object","additionalProperties":true},"capabilities":{"type":"object","additionalProperties":true},"product_group":{"type":"object","additionalProperties":true},"purchase_options":{"type":"array","items":{"type":"object","additionalProperties":true}},"variants":{"type":"array","items":{"$ref":"#/components/schemas/ProductVariant"}},"artwork_upload_requirements":{"type":"object","additionalProperties":true},"links":{"type":"object","additionalProperties":true}}}}}}