{"openapi":"3.1.0","info":{"title":"Inkgility public API","version":"1.0.0","summary":"Anonymous, read-only access to the Inkgility catalog and live price quotes.","description":"Products, categories, design templates, articles and price quotes from the same services that power inkgility.com. No API key. Open CORS for GET. Responses are cached and carry ETags; send If-None-Match to receive 304.","contact":{"name":"Inkgility developers","url":"https://dev.inkgility.com/developers","email":"sales@inkgility.com"}},"servers":[{"url":"https://dev.inkgility.com/api/v1"}],"tags":[{"name":"Catalog","description":"Products, categories, templates."},{"name":"Content","description":"Articles."},{"name":"Pricing","description":"Live quotes."},{"name":"Meta","description":"Discovery."}],"paths":{"/":{"get":{"tags":["Meta"],"operationId":"getIndex","summary":"API index","responses":{"200":{"description":"Endpoint list."},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/products":{"get":{"tags":["Catalog"],"operationId":"listProducts","summary":"List products","description":"Same filters as the storefront: search, sort, tier, price band and any facet slug (comma-separated for multi-select).","parameters":[{"name":"search","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","description":"Category slug.","schema":{"type":"string"}},{"name":"per_page","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":24}},{"name":"cursor","in":"query","description":"Opaque cursor from meta.next_cursor.","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"tier","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"A page of products.","headers":{"ETag":{"$ref":"#/components/headers/ETag"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Product"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/products/{slug}":{"get":{"tags":["Catalog"],"operationId":"getProduct","summary":"One product","parameters":[{"name":"slug","in":"path","required":true,"description":"The product slug.","schema":{"type":"string"}}],"responses":{"200":{"description":"The product.","headers":{"ETag":{"$ref":"#/components/headers/ETag"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Product"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/categories":{"get":{"tags":["Catalog"],"operationId":"listCategories","summary":"Category tree","responses":{"200":{"description":"Top-level categories with their children.","headers":{"ETag":{"$ref":"#/components/headers/ETag"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Category"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/templates":{"get":{"tags":["Catalog"],"operationId":"listTemplates","summary":"List design templates","parameters":[{"name":"search","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","description":"Category slug.","schema":{"type":"string"}},{"name":"per_page","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":24}},{"name":"cursor","in":"query","description":"Opaque cursor from meta.next_cursor.","schema":{"type":"string"}},{"name":"tier","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"A page of templates.","headers":{"ETag":{"$ref":"#/components/headers/ETag"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Template"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/articles":{"get":{"tags":["Content"],"operationId":"listArticles","summary":"List articles","parameters":[{"name":"category","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Articles, newest first.","headers":{"ETag":{"$ref":"#/components/headers/ETag"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Article"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/articles/{slug}":{"get":{"tags":["Content"],"operationId":"getArticle","summary":"One article","parameters":[{"name":"slug","in":"path","required":true,"description":"The article slug.","schema":{"type":"string"}}],"responses":{"200":{"description":"The article.","headers":{"ETag":{"$ref":"#/components/headers/ETag"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Article"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/quote":{"get":{"tags":["Pricing"],"operationId":"getQuote","summary":"Live price quote","description":"Prices the product at the cheapest default options at the next quantity rung at or above the request, matching the MCP get_price_quote tool. Optional options[key]=index overrides pick a different choice (for example options[material]=1). Excludes shipping and tax.","parameters":[{"name":"product","in":"query","required":true,"description":"Category or calculator slug, e.g. business-cards.","schema":{"type":"string"}},{"name":"quantity","in":"query","required":true,"schema":{"type":"integer","minimum":1}},{"name":"options","in":"query","style":"deepObject","explode":true,"description":"Selection index overrides keyed by option name.","schema":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}}],"responses":{"200":{"description":"The quote.","headers":{"ETag":{"$ref":"#/components/headers/ETag"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Quote"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/openapi.json":{"get":{"tags":["Meta"],"operationId":"getOpenApi","summary":"This document","responses":{"200":{"description":"OpenAPI 3.1 document."},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/RateLimited"}}}}},"components":{"headers":{"ETag":{"description":"Strong validator; send back as If-None-Match.","schema":{"type":"string"}}},"responses":{"NotModified":{"description":"The representation has not changed (If-None-Match matched)."},"NotFound":{"description":"Unknown resource or endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Invalid":{"description":"Invalid parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Too many requests; see Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Meta":{"type":"object","properties":{"total":{"type":"integer"},"count":{"type":"integer"},"next_cursor":{"type":["string","null"]}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object"}}}}},"Product":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"tier":{"type":["string","null"]},"price_usd":{"type":["number","null"]},"image":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string"}},"material":{"type":["string","null"]},"industry":{"type":["string","null"]},"finish":{"type":["string","null"]},"description":{"type":["string","null"]}}},"Category":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"description":{"type":["string","null"]},"url":{"type":"string","format":"uri"},"children":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"description":{"type":["string","null"]},"url":{"type":"string","format":"uri"}}}}}},"Template":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"product_slug":{"type":["string","null"]},"category":{"type":["string","null"]},"tier":{"type":["string","null"]},"price":{"type":["number","null"]},"image":{"type":["string","null"]}}},"Article":{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"published":{"type":"string","format":"date"},"reading_time":{"type":"string"},"url":{"type":"string","format":"uri"},"cover":{"type":["string","null"]}}},"Quote":{"type":"object","properties":{"product":{"type":"string"},"requested_quantity":{"type":"integer"},"quoted_quantity":{"type":"integer"},"total_usd":{"type":"number"},"unit_usd":{"type":["number","null"]},"options":{"type":"object","additionalProperties":{"type":"integer"}},"specs":{"type":"array","items":{"type":"string"}},"ladder":{"type":"array","items":{"type":"object","properties":{"quantity":{"type":"integer"},"price_usd":{"type":"number"}}}},"notes":{"type":"string"},"url":{"type":"string","format":"uri"}}}}}}