{ "components": { "schemas": { "product": { "properties": { "name": { "type": "string", "description": "Product name" }, "product": { "type": "string", "description": "URL to product object" }, "id": { "type": "integer", "format": "int64", "description": "Unique identifier for product" }, "brand": { "type": "string", "description": "Brand name" }, "url": { "type": "string", "description": "Link to product detail page where item can be purchased" }, "content": { "$ref": "#/components/schemas/product_content" }, "categories": { "items": { "type": "string" }, "type": "array", "description": "A list of categories to which this product belongs." }, "image_urls": { "type": "object", "description": "A map of key/value pairs with the key being the image resolution WIDTHxHEIGHT and the value being an array of image objects." }, "skus": { "items": { "$ref": "#/components/schemas/sku" }, "type": "array", "description": "List of Skus" } }, "required": [ "name", "product", "id", "brand", "url", "content", "categories", "image_urls", "skus" ], "type": "object" }, "product_categories": { "properties": { "categories": { "items": { "type": "string" }, "type": "array", "description": "A list of categories to which this product belongs." } }, "required": [ "categories" ], "type": "object" }, "product_content": { "properties": { "description": { "type": "string", "description": "Product description." }, "fit_notes": { "type": "string", "description": "Sizing information." }, "material": { "type": "string", "description": "Materials list." }, "care_instructions": { "type": "string", "description": "Additional care information." }, "origin": { "type": "string", "description": "Place of manufacture." } }, "type": "object" }, "sale_detail": { "properties": { "name": { "type": "string", "description": "Sale name" }, "sale": { "type": "string", "description": "URL to single sale object" }, "sale_key": { "type": "string", "description": "unique identifier for sale" }, "store": { "$ref": "#/components/schemas/store", "description": "Store key" }, "description": { "type": "string", "description": "A description of the sale's theme or brand" }, "sale_url": { "type": "string", "description": "Permalink to sale website" }, "begins": { "type": "string", "format": "date-time", "description": "ISO8601-formatted time for beginning of sale" }, "ends": { "type": "string", "format": "date-time", "description": "ISO-8601-formatted time for end of sale" }, "image_urls": { "type": "object", "description": "A map of key/value pairs with the key being the image resolution WIDTHxHEIGHT and the value being an array of image objects." }, "products": { "items": { "type": "string" }, "type": "array", "description": "List of URLs to individual product objects (not available if sale is upcoming or sold out)" } }, "required": [ "name", "sale", "sale_key", "store", "sale_url", "begins", "image_urls" ], "type": "object" }, "sale_list": { "properties": { "sales": { "items": { "$ref": "#/components/schemas/sale_detail" }, "type": "array", "description": "List of sales." } }, "required": [ "sales" ], "type": "object" }, "sku": { "properties": { "id": { "type": "integer", "format": "int64", "description": "The SKU unique identifier" }, "inventory_status": { "type": "string", "description": "Describes product availability. One of: sold out, for sale or reserved." }, "msrp_price": { "type": "number", "format": "float", "description": "MSRP price of SKU in US Dollars." }, "sale_price": { "type": "number", "format": "float", "description": "Sale price of SKU in US Dollars." }, "shipping_surcharge": { "type": "number", "format": "float", "description": "If absent, standard Gilt.com shipping policy and any resulting charges apply. If present, standard shipping charge is overridden by amount listed here in US Dollars." }, "attributes": { "items": { "type": "object" }, "type": "array", "description": "SKU attributes like color and size." } }, "required": [ "id", "inventory_status", "msrp_price", "sale_price", "attributes" ], "type": "object" }, "store": { "description": "Gilt.com is divided into stores. Currently there are four stores exposed by the API: Women, Men, Baby & Kids and Home. Possible values: women,men,kids,home.", "enum": [ "women", "men", "kids", "home" ], "type": "string" } } }, "info": { "contact": {}, "description": "Gilt Public API: dev.gilt.com", "license": {}, "termsOfService": "", "title": "gilt-public-api", "version": "1.0.1" }, "openapi": "3.0.2", "paths": { "/products/:productId/detail.json": { "get": { "operationId": "get--products-productId-detailjson", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "name": "productId" }, { "deprecated": false, "in": "query", "required": true, "schema": { "type": "string" }, "name": "apikey" } ], "responses": { "200": { "description": "com.gilt.public.api.models.product", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/product" } } }, "headers": {} } }, "tags": [ "product" ] } }, "/products/categories.json": { "get": { "operationId": "get--products-categoriesjson", "parameters": [ { "deprecated": false, "in": "query", "required": true, "schema": { "type": "string" }, "name": "apikey" } ], "responses": { "200": { "description": "com.gilt.public.api.models.product_categories", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/product_categories" } } }, "headers": {} } }, "tags": [ "product" ] } }, "/sales/:store/:saledetail.json": { "get": { "operationId": "get--sales-store-saledetailjson", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "$ref": "#/components/schemas/store" }, "name": "store" }, { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "name": "sale" }, { "deprecated": false, "in": "query", "required": true, "schema": { "type": "string" }, "name": "apikey" } ], "responses": { "200": { "description": "com.gilt.public.api.models.sale_detail", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sale_detail" } } }, "headers": {} } }, "tags": [ "sale_detail" ] } }, "/sales/active.json": { "get": { "operationId": "get--sales-activejson", "parameters": [ { "deprecated": false, "in": "query", "required": true, "schema": { "type": "string" }, "name": "apikey" } ], "responses": { "200": { "description": "com.gilt.public.api.models.sale_list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sale_list" } } }, "headers": {} } }, "tags": [ "sale_list" ] } }, "/sales/:store/active.json": { "get": { "operationId": "get--sales-store-activejson", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "name": "store" }, { "deprecated": false, "in": "query", "required": true, "schema": { "type": "string" }, "name": "apikey" } ], "responses": { "200": { "description": "com.gilt.public.api.models.sale_list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sale_list" } } }, "headers": {} } }, "tags": [ "sale_list" ] } }, "/sales/upcoming.json": { "get": { "operationId": "get--sales-upcomingjson", "parameters": [ { "deprecated": false, "in": "query", "required": true, "schema": { "type": "string" }, "name": "apikey" } ], "responses": { "200": { "description": "com.gilt.public.api.models.sale_list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sale_list" } } }, "headers": {} } }, "tags": [ "sale_list" ] } }, "/sales/:store/upcoming.json": { "get": { "operationId": "get--sales-store-upcomingjson", "parameters": [ { "deprecated": false, "in": "path", "required": true, "schema": { "type": "string" }, "name": "store" }, { "deprecated": false, "in": "query", "required": true, "schema": { "type": "string" }, "name": "apikey" } ], "responses": { "200": { "description": "com.gilt.public.api.models.sale_list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sale_list" } } }, "headers": {} } }, "tags": [ "sale_list" ] } } }, "servers": [ { "url": "https://api.gilt.com/v1" } ] }