{"openapi":"3.1.0","info":{"title":"RuneLore public catalog","version":"1.5.0","description":"Search the combined RuneLore product catalog. Where supplied, prices are RuneLore merchandise prices including the selected printing and service margin; shipping and applicable tax are separate. Supplier costs are private. No owner credentials or payment card are required for catalog reads."},"servers":[{"url":"https://runeloresupply.com"}],"security":[],"paths":{"/discovery/v1/capabilities":{"get":{"operationId":"get_service_capabilities","description":"Read current availability, limits and connection links.","security":[],"parameters":[],"responses":{"200":{"description":"Observed supplier product information. Product presence does not guarantee live price, stock or order availability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Capabilities"}}}},"400":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/discovery/v1/products":{"get":{"operationId":"find_products","description":"Search the combined RuneLore catalog. Exact product matches rank before related products.","security":[],"parameters":[{"name":"search","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["clothing","outerwear","footwear","kitchen","home","bags","accessories","toys-games","wall-art","stationery","kids","pets","tech","more"]}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["relevance","price-asc","price-desc","name"]}},{"name":"maxPrice","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,2})?$"}},{"name":"size","in":"query","required":false,"schema":{"type":"string","maxLength":80}},{"name":"color","in":"query","required":false,"schema":{"type":"string","maxLength":80}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":40,"default":20}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":2048}}],"responses":{"200":{"description":"Observed supplier product information. Product presence does not guarantee live price, stock or order availability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/discovery/v1/products/{id}":{"get":{"operationId":"get_product","description":"Read one RuneLore product and its details.","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^(?:[1-9][0-9]{0,14}|[a-z][a-z0-9-]{0,79})$"}}],"responses":{"200":{"description":"Observed supplier product information. Product presence does not guarantee live price, stock or order availability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Detail"}}}},"400":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/discovery/v1/products/{id}/variants":{"get":{"operationId":"get_product_variants","description":"Read paginated published size/color information. Variant presence is not a stock guarantee.","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^(?:[1-9][0-9]{0,14}|[a-z][a-z0-9-]{0,79})$"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":40}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":2048}}],"responses":{"200":{"description":"Observed supplier product information. Product presence does not guarantee live price, stock or order availability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Variants"}}}},"400":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid query, changed catalog, request limit, or unavailable public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Product":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"kind":{"type":"string"},"audience":{"type":"string"},"garmentType":{"type":"string"},"thumbnailUrl":{"type":"string","format":"uri"},"imageUrls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Distinct original supplier photographs, supplied on product detail reads."},"variantCount":{"type":"integer"},"categories":{"type":"array","items":{"type":"string","enum":["clothing","outerwear","footwear","kitchen","home","bags","accessories","toys-games","wall-art","stationery","kids","pets","tech","more"]}},"canCustomize":{"type":"boolean"},"price":{"type":"object","additionalProperties":false,"properties":{"currency":{"const":"USD"},"amountMinor":{"type":"integer","minimum":1},"fromMinor":{"type":"integer","minimum":1},"toMinor":{"type":"integer","minimum":1},"printingIncluded":{"type":"boolean"},"expiresAt":{"type":"string","format":"date-time"}},"required":["currency","printingIncluded","expiresAt"]}},"required":["id","title","kind","variantCount"]},"Variant":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"title":{"type":"string"},"canCustomize":{"type":"boolean"},"price":{"type":"object","additionalProperties":false,"properties":{"currency":{"const":"USD"},"amountMinor":{"type":"integer","minimum":1},"fromMinor":{"type":"integer","minimum":1},"toMinor":{"type":"integer","minimum":1},"printingIncluded":{"type":"boolean"},"expiresAt":{"type":"string","format":"date-time"}},"required":["currency","printingIncluded","expiresAt"]},"back":{"type":"object","additionalProperties":false,"properties":{"width":{"type":"number"},"height":{"type":"number"}}},"size":{"type":"string"},"color":{"type":"string"},"colorCode":{"type":"string"},"materialLabel":{"type":"string"},"attributes":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}},"required":["name","value"],"additionalProperties":false}},"imageUrl":{"type":"string","format":"uri","description":"Saved supplier photograph matched to this exact published product and variant."},"front":{"type":"object","additionalProperties":false,"properties":{"width":{"type":"number"},"height":{"type":"number"}}}},"required":["id"]},"Page":{"type":"object","properties":{"scope":{"enum":["supplier_catalog","public_retail_preview"]},"version":{"type":"string"},"capturedAt":{"type":"string","format":"date-time"},"timestampBasis":{"const":"runelore_public_catalog_read"},"wholesaleAvailable":{"const":false},"resaleRightsVerified":{"const":false},"platformFulfillmentAvailable":{"const":false},"websiteControl":{"const":false},"websiteCheckoutAvailable":{"type":"boolean","description":"Ordering on RuneLore, separate from this read-only API."},"retailCheckoutAvailable":{"type":"boolean"},"externalStoreOrderingAvailable":{"const":false},"products":{"type":"array","items":{"$ref":"#/components/schemas/Product"}},"total":{"type":"integer"},"search":{"type":"string"},"category":{"type":"string"},"nextCursor":{"type":["string","null"]}},"required":["scope","products","total","nextCursor"]},"Detail":{"type":"object","properties":{"scope":{"enum":["supplier_catalog","public_retail_preview"]},"version":{"type":"string"},"capturedAt":{"type":"string","format":"date-time"},"timestampBasis":{"const":"runelore_public_catalog_read"},"wholesaleAvailable":{"const":false},"resaleRightsVerified":{"const":false},"platformFulfillmentAvailable":{"const":false},"websiteControl":{"const":false},"websiteCheckoutAvailable":{"type":"boolean","description":"Ordering on RuneLore, separate from this read-only API."},"retailCheckoutAvailable":{"type":"boolean"},"externalStoreOrderingAvailable":{"const":false},"product":{"$ref":"#/components/schemas/Product"}},"required":["scope","product"]},"Variants":{"type":"object","properties":{"scope":{"enum":["supplier_catalog","public_retail_preview"]},"version":{"type":"string"},"capturedAt":{"type":"string","format":"date-time"},"timestampBasis":{"const":"runelore_public_catalog_read"},"wholesaleAvailable":{"const":false},"resaleRightsVerified":{"const":false},"platformFulfillmentAvailable":{"const":false},"websiteControl":{"const":false},"websiteCheckoutAvailable":{"type":"boolean","description":"Ordering on RuneLore, separate from this read-only API."},"retailCheckoutAvailable":{"type":"boolean"},"externalStoreOrderingAvailable":{"const":false},"productId":{"type":"string"},"variants":{"type":"array","items":{"$ref":"#/components/schemas/Variant"}},"total":{"type":"integer"},"nextCursor":{"type":["string","null"]}},"required":["scope","productId","variants","total","nextCursor"]},"Capabilities":{"type":"object","properties":{"service":{"const":"RuneLore"},"publicCatalog":{"type":"object"},"access":{"type":"object"},"links":{"type":"object"},"limits":{"type":"object"},"commercialStatus":{"type":"object"}},"required":["service","publicCatalog","access","links","limits","commercialStatus"]},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}},"x-shop-api-enabled":false,"x-live-payments-enabled":true,"x-payment-scope":"RuneLore website checkout only","x-external-store-ordering-enabled":false,"x-website-control":false}