openapi-directory
Version:
Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS
1 lines • 61.5 kB
JSON
{"openapi":"3.0.0","info":{"description":"The shop API empowers developers to build amazing new apps or websites using Zalando shop data and services.","title":"Zalando Shop","version":"v1.0","x-apisguru-categories":["ecommerce"],"x-logo":{"url":"https://twitter.com/Zalando/profile_image?size=original"},"x-origin":[{"format":"swagger","url":"https://api.zalando.com/schema/swagger.json","version":"2.0"}],"x-providerName":"zalando.com"},"paths":{"/article-reviews":{"get":{"description":"Zalando API Article Reviews Schema","parameters":[{"description":"Article IDs. A list of config SKUs for which the article reviews will be returned.\nRequired if articleModelId is empty.\n","in":"query","name":"articleId","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Article model IDs. A list of model SKUs for which the article reviews will be returned.\nRequired if articleId is empty.\n","in":"query","name":"articleModelId","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"$ref":"#/components/parameters/minStarRating"},{"$ref":"#/components/parameters/maxStarRating"},{"$ref":"#/components/parameters/articleReviewSort"},{"$ref":"#/components/parameters/page"},{"$ref":"#/components/parameters/pageSize"},{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Articles Reviews response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Article-Reviews"},"examples":{"response":{"value":{"content":[{"articleId":"EW012B00C-C11","articleModelId":"EW012B00C","articleSizeRatings":{"OVERALL":3,"SHOE_WIDTH":3},"created":"2025-06-15T13:47:09.787Z","customerCity":"Brixton","customerCountry":"GB","description":"Very nice trainers, with an extremely prompt arrival... ","helpfulCount":0,"language":"en","rating":5,"recommend":false,"reviewId":"4405383-EW012B00C-C11","title":"Dream turned to reality in the blink of an eye!","unhelpfulCount":0}]}}}}}},"400":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"Get Article Reviews","tags":["articles"]}},"/article-reviews-summaries":{"get":{"description":"Zalando API Article Reviews Summaries Schema","parameters":[{"description":"Article model IDs. A list of model SKUs for which the article review summaries will be returned.","in":"query","name":"articleModelId","required":true,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"$ref":"#/components/parameters/page"},{"$ref":"#/components/parameters/pageSize"},{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Articles Reviews Summaries response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Article-Reviews-Summaries"},"examples":{"response":{"value":{"content":[{"articleModelId":"K4411C00Y","averageStarRating":4,"numberOfUserPositiveRecommendations":0,"numberOfUserRecommendations":0,"numberOfUserReviews":1,"starRatingDistribution":{"1":0,"2":0,"3":0,"4":1,"5":0}}]}}}}}},"400":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"Get Article Reviews Summaries","tags":["articles"]}},"/article-reviews-summaries/{articleModelId}":{"get":{"description":"Zalando API ArticleReviewsSummaries Schema","parameters":[{"description":"To get unique reviews summary from article model Id.","in":"path","name":"articleModelId","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Articles Reviews Summaries by articleModelId response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Article-Reviews-Summary"},"examples":{"response":{"value":{"articleModelId":"K4411C00Y","averageStarRating":4,"numberOfUserPositiveRecommendations":0,"numberOfUserRecommendations":0,"numberOfUserReviews":1,"starRatingDistribution":{"1":0,"2":0,"3":0,"4":1,"5":0}}}}}}},"400":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"Get Article Reviews Summaries by articleModelId","tags":["articles"]}},"/article-reviews/{reviewId}":{"get":{"description":"Zalando API ArticleReviews Schema","parameters":[{"description":"To get unique review by review Id.","in":"path","name":"reviewId","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Articles Reviews by reviewId response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Article-Review"},"examples":{"response":{"value":{"articleId":"EW012B00C-C11","articleModelId":"EW012B00C","articleSizeRatings":{"OVERALL":3,"SHOE_WIDTH":3},"created":"2025-06-15T13:47:09.787Z","customerCity":"Brixton","customerCountry":"GB","description":"Very nice trainers, with an extremely prompt arrival...","helpfulCount":0,"language":"en","rating":5,"recommend":false,"reviewId":"4405383-EW012B00C-C11","title":"Dream turned to reality in the blink of an eye!","unhelpfulCount":0}}}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"Get Article Reviews by reviewId","tags":["articles"]}},"/articles":{"get":{"description":"Search for articles based on various different possible filter like e.g. the `brandFamily`, the `catagory` or a\nspecific `color`. See [Filters](https://todo) for a list of all available filter options.\n\nThe default `pageSize` for responses is set to `20`. You can add a `pageSize` request parameter to adjust that.\nPlease keep in mind that the maximum `pageSize` for this resource is `200`.\n\nThe endpoint also supports reducing the fields returned for each article via the `fields` parameter. Please\nrefer to [fields parameter](https://todo) for more details.","parameters":[{"$ref":"#/components/parameters/articleId"},{"$ref":"#/components/parameters/articleModelId"},{"$ref":"#/components/parameters/articleUnitId"},{"$ref":"#/components/parameters/activationDate"},{"$ref":"#/components/parameters/ageGroup"},{"$ref":"#/components/parameters/assortmentArea"},{"$ref":"#/components/parameters/brand"},{"$ref":"#/components/parameters/brandfamily"},{"$ref":"#/components/parameters/category"},{"$ref":"#/components/parameters/color"},{"$ref":"#/components/parameters/den"},{"$ref":"#/components/parameters/filling"},{"$ref":"#/components/parameters/fullText"},{"$ref":"#/components/parameters/gender"},{"$ref":"#/components/parameters/heelForm"},{"$ref":"#/components/parameters/heelHeight"},{"$ref":"#/components/parameters/length"},{"$ref":"#/components/parameters/occasion"},{"$ref":"#/components/parameters/pattern"},{"$ref":"#/components/parameters/price"},{"$ref":"#/components/parameters/sale"},{"$ref":"#/components/parameters/season"},{"$ref":"#/components/parameters/shaftHeight"},{"$ref":"#/components/parameters/shaftWidth"},{"$ref":"#/components/parameters/shirtCollar"},{"$ref":"#/components/parameters/shoeFastener"},{"$ref":"#/components/parameters/shoeToecap"},{"$ref":"#/components/parameters/shopArea"},{"$ref":"#/components/parameters/size"},{"$ref":"#/components/parameters/sports"},{"$ref":"#/components/parameters/technology"},{"$ref":"#/components/parameters/trouserRise"},{"$ref":"#/components/parameters/upperMaterial"},{"$ref":"#/components/parameters/volume"},{"$ref":"#/components/parameters/page"},{"$ref":"#/components/parameters/pageSize"},{"$ref":"#/components/parameters/sort"},{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Articles response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Articles"},"examples":{"response":{"value":{"content":[{"activationDate":"2025-06-15T13:47:09.787Z","additionalInfos":[],"ageGroups":["BABY"],"attributes":[{"name":"Total length","values":["10.0 \" (Size 50)"]},{"name":"Fabric","values":["Jersey"]},{"name":"Length","values":["Standard"]},{"name":"Pattern","values":["Print"]},{"name":"Fit","values":["normal"]},{"name":"Occasion","values":["Leisure"]},{"name":"Neckline","values":["Envelope"]},{"name":"sleeve length","values":["8.0 \" (Size 50)"]},{"name":"outer fabric material","values":["100% cotton"]},{"name":"Sleeve length","values":["Long sleeve"]}],"available":false,"brand":{"key":"BE8","logoLargeUrl":"https://i2.ztat.net/brandxl/belly-button-1.jpg","logoUrl":"https://i2.ztat.net/brand/belly-button-1.jpg","name":"bellybutton","shopUrl":"https://www.zalando.co.uk/belly-button"},"categoryKeys":["catalog","kids","childrens-clothing","kids-clothing-shirts-tops","kids-clothing-long-sleeve-tops","all","clothing"],"color":"Grey","genders":["MALE"],"id":"BE824G002-C11","media":{"images":[{"largeHdUrl":"https://i2.ztat.net/large_hd/BE/82/4G/00/2C/11/BE824G002-C11@8.jpg","largeUrl":"https://i2.ztat.net/large/BE/82/4G/00/2C/11/BE824G002-C11@8.jpg","mediumHdUrl":"https://i2.ztat.net/detail_hd/BE/82/4G/00/2C/11/BE824G002-C11@8.jpg","mediumUrl":"https://i2.ztat.net/detail/BE/82/4G/00/2C/11/BE824G002-C11@8.jpg","orderNumber":1,"smallHdUrl":"https://i2.ztat.net/catalog_hd/BE/82/4G/00/2C/11/BE824G002-C11@8.jpg","smallUrl":"https://i2.ztat.net/catalog/BE/82/4G/00/2C/11/BE824G002-C11@8.jpg","thumbnailHdUrl":"https://i2.ztat.net/thumb_hd/BE/82/4G/00/2C/11/BE824G002-C11@8.jpg","type":"NON_MODEL"},{"largeHdUrl":"https://i1.ztat.net/large_hd/BE/82/4G/00/2C/11/BE824G002-C11@7.jpg","largeUrl":"https://i1.ztat.net/large/BE/82/4G/00/2C/11/BE824G002-C11@7.jpg","mediumHdUrl":"https://i1.ztat.net/detail_hd/BE/82/4G/00/2C/11/BE824G002-C11@7.jpg","mediumUrl":"https://i1.ztat.net/detail/BE/82/4G/00/2C/11/BE824G002-C11@7.jpg","orderNumber":2,"smallHdUrl":"https://i1.ztat.net/catalog_hd/BE/82/4G/00/2C/11/BE824G002-C11@7.jpg","smallUrl":"https://i1.ztat.net/catalog/BE/82/4G/00/2C/11/BE824G002-C11@7.jpg","thumbnailHdUrl":"https://i1.ztat.net/thumb_hd/BE/82/4G/00/2C/11/BE824G002-C11@7.jpg","type":"NON_MODEL"},{"largeHdUrl":"https://i2.ztat.net/large_hd/BE/82/4G/00/2C/11/BE824G002-C11@6.jpg","largeUrl":"https://i2.ztat.net/large/BE/82/4G/00/2C/11/BE824G002-C11@6.jpg","mediumHdUrl":"https://i2.ztat.net/detail_hd/BE/82/4G/00/2C/11/BE824G002-C11@6.jpg","mediumUrl":"https://i2.ztat.net/detail/BE/82/4G/00/2C/11/BE824G002-C11@6.jpg","orderNumber":3,"smallHdUrl":"https://i2.ztat.net/catalog_hd/BE/82/4G/00/2C/11/BE824G002-C11@6.jpg","smallUrl":"https://i2.ztat.net/catalog/BE/82/4G/00/2C/11/BE824G002-C11@6.jpg","thumbnailHdUrl":"https://i2.ztat.net/thumb_hd/BE/82/4G/00/2C/11/BE824G002-C11@6.jpg","type":"NON_MODEL"},{"largeHdUrl":"https://i3.ztat.net/large_hd/BE/82/4G/00/2C/11/BE824G002-C11@5.jpg","largeUrl":"https://i3.ztat.net/large/BE/82/4G/00/2C/11/BE824G002-C11@5.jpg","mediumHdUrl":"https://i3.ztat.net/detail_hd/BE/82/4G/00/2C/11/BE824G002-C11@5.jpg","mediumUrl":"https://i3.ztat.net/detail/BE/82/4G/00/2C/11/BE824G002-C11@5.jpg","orderNumber":4,"smallHdUrl":"https://i3.ztat.net/catalog_hd/BE/82/4G/00/2C/11/BE824G002-C11@5.jpg","smallUrl":"https://i3.ztat.net/catalog/BE/82/4G/00/2C/11/BE824G002-C11@5.jpg","thumbnailHdUrl":"https://i3.ztat.net/thumb_hd/BE/82/4G/00/2C/11/BE824G002-C11@5.jpg","type":"NON_MODEL"}]},"modelId":"BE824G002","name":"Long sleeved top - stormy weather","season":"SUMMER","seasonYear":"2015","shopUrl":"https://www.zalando.co.uk/bellybutton-long-sleeved-top-grey-be824g002-c11.html","units":[{"available":false,"id":"BE824G002-C110068000","originalPrice":{"currency":"GBP","formatted":"£11.00","value":11},"price":{"currency":"GBP","formatted":"£11.00","value":11},"size":"4-6m","stock":0},{"available":false,"id":"BE824G002-C110062000","originalPrice":{"currency":"GBP","formatted":"£11.00","value":11},"price":{"currency":"GBP","formatted":"£11.00","value":11},"size":"2-4m","stock":0},{"available":false,"id":"BE824G002-C110074000","originalPrice":{"currency":"GBP","formatted":"£11.00","value":11},"price":{"currency":"GBP","formatted":"£11.00","value":11},"size":"6-9m","stock":0},{"available":false,"id":"BE824G002-C110050000","originalPrice":{"currency":"GBP","formatted":"£11.00","value":11},"price":{"currency":"GBP","formatted":"£11.00","value":11},"size":"1m","stock":0},{"available":false,"id":"BE824G002-C110056000","originalPrice":{"currency":"GBP","formatted":"£11.00","value":11},"price":{"currency":"GBP","formatted":"£11.00","value":11},"size":"2m","stock":0}]}]}}}}}},"400":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"Search for Articles","tags":["articles"]}},"/articles/{articleId}":{"get":{"description":"Zalando API Article Schema","parameters":[{"description":"To get unique article for article Id.","in":"path","name":"articleId","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Article response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Article"},"examples":{"response":{"value":{"activationDate":"2025-06-15T13:47:09.787Z","additionalInfos":[],"ageGroups":["ADULT"],"attributes":[{"name":"Neckline","values":["Crew neck"]},{"name":"Fit","values":["Waisted"]}],"available":true,"brand":{"key":"AN6","logoUrl":"https://i6.ztat.net/brand/anna-field.jpg","name":"Anna Field","shopUrl":"https://www.zalando.co.uk/anna-field"},"categoryKeys":["catalog","women","womens-clothing","womens-clothing-dresses","summer-dresses","all","clothing"],"color":"Blue","genders":["FEMALE"],"id":"AN621C0S5-K11","media":{"images":[{"largeHdUrl":"https://i2.ztat.net/large_hd/AN/62/1C/0S/5K/11/AN621C0S5-K11@16.jpg","largeUrl":"https://i2.ztat.net/large/AN/62/1C/0S/5K/11/AN621C0S5-K11@16.jpg","mediumHdUrl":"https://i2.ztat.net/detail_hd/AN/62/1C/0S/5K/11/AN621C0S5-K11@16.jpg","mediumUrl":"https://i2.ztat.net/detail/AN/62/1C/0S/5K/11/AN621C0S5-K11@16.jpg","orderNumber":1,"smallHdUrl":"https://i2.ztat.net/catalog_hd/AN/62/1C/0S/5K/11/AN621C0S5-K11@16.jpg","smallUrl":"https://i2.ztat.net/catalog/AN/62/1C/0S/5K/11/AN621C0S5-K11@16.jpg","thumbnailHdUrl":"https://i2.ztat.net/thumb_hd/AN/62/1C/0S/5K/11/AN621C0S5-K11@16.jpg","type":"NON_MODEL"},{"largeHdUrl":"https://i3.ztat.net/large_hd/AN/62/1C/0S/5K/11/AN621C0S5-K11@15.jpg","largeUrl":"https://i3.ztat.net/large/AN/62/1C/0S/5K/11/AN621C0S5-K11@15.jpg","mediumHdUrl":"https://i3.ztat.net/detail_hd/AN/62/1C/0S/5K/11/AN621C0S5-K11@15.jpg","mediumUrl":"https://i3.ztat.net/detail/AN/62/1C/0S/5K/11/AN621C0S5-K11@15.jpg","orderNumber":2,"smallHdUrl":"https://i3.ztat.net/catalog_hd/AN/62/1C/0S/5K/11/AN621C0S5-K11@15.jpg","smallUrl":"https://i3.ztat.net/catalog/AN/62/1C/0S/5K/11/AN621C0S5-K11@15.jpg","thumbnailHdUrl":"https://i3.ztat.net/thumb_hd/AN/62/1C/0S/5K/11/AN621C0S5-K11@15.jpg","type":"STYLE"}]},"modelId":"AN621C0S5","name":"Summer dress - blue/white","season":"SUMMER","seasonYear":"2015","shopUrl":"https://www.zalando.co.uk/anna-field-summer-dress-blue-white-an621c0s5-k11.html","units":[{"available":true,"id":"AN621C0S5-K110420000","originalPrice":{"currency":"GBP","formatted":"£21.00","value":21},"price":{"currency":"GBP","formatted":"£21.00","value":21},"size":"16","stock":3}]}}}}}},"400":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"Get Article by articleId","tags":["articles"]}},"/articles/{articleId}/media":{"get":{"description":"Zalando API Article Schema","parameters":[{"description":"To get unique article for article Id media.","in":"path","name":"articleId","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Article response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Article-Media"},"examples":{"response":{"value":{"images":[{"largeHdUrl":"https://i2.ztat.net/large_hd/BE/82/4G/00/2C/11/BE824G002-C11@8.jpg","largeUrl":"https://i2.ztat.net/large/BE/82/4G/00/2C/11/BE824G002-C11@8.jpg","mediumHdUrl":"https://i2.ztat.net/detail_hd/BE/82/4G/00/2C/11/BE824G002-C11@8.jpg","mediumUrl":"https://i2.ztat.net/detail/BE/82/4G/00/2C/11/BE824G002-C11@8.jpg","orderNumber":1,"smallHdUrl":"https://i2.ztat.net/catalog_hd/BE/82/4G/00/2C/11/BE824G002-C11@8.jpg","smallUrl":"https://i2.ztat.net/catalog/BE/82/4G/00/2C/11/BE824G002-C11@8.jpg","thumbnailHdUrl":"https://i2.ztat.net/thumb_hd/BE/82/4G/00/2C/11/BE824G002-C11@8.jpg","type":"NON_MODEL"}]}}}}}},"400":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"Get Article media by articleId","tags":["articles"]}},"/articles/{articleId}/reviews":{"get":{"description":"Zalando API Article Schema","parameters":[{"description":"To get unique article for article Id reviews.","in":"path","name":"articleId","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/minStarRating"},{"$ref":"#/components/parameters/maxStarRating"},{"$ref":"#/components/parameters/articleReviewSort"},{"$ref":"#/components/parameters/page"},{"$ref":"#/components/parameters/pageSize"},{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Article response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Article-Reviews"},"examples":{"response":{"value":{"content":[{"articleId":"EW012B00C-C11","articleModelId":"EW012B00C","articleSizeRatings":{"OVERALL":3,"SHOE_WIDTH":3},"created":"2025-06-15T13:47:09.787Z","customerCity":"Brixton","customerCountry":"GB","description":"Very nice trainers, with an extremely prompt arrival...","helpfulCount":0,"language":"en","rating":5,"recommend":false,"reviewId":"4405383-EW012B00C-C11","title":"Dream turned to reality in the blink of an eye!","unhelpfulCount":0}],"page":1,"size":1,"totalElements":1,"totalPages":1}}}}}},"400":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"Get Article reviews by articleId","tags":["articles"]}},"/articles/{articleId}/reviews-summary":{"get":{"description":"Zalando API Article Schema","parameters":[{"description":"To get unique article for article Id reviews summary.","in":"path","name":"articleId","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Article response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Article-Reviews-Summary"},"examples":{"response":{"value":{"articleModelId":"EW012B00C","articleSizeRatings":{"OVERALL":3,"SHOE_WIDTH":3},"averageStarRating":5,"numberOfUserPositiveRecommendations":0,"numberOfUserRecommendations":1,"numberOfUserReviews":1,"starRatingDistribution":{"1":0,"2":0,"3":0,"4":0,"5":1}}}}}}},"400":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"Get Article reviews summary by articleId","tags":["articles"]}},"/articles/{articleId}/units":{"get":{"description":"Zalando API Article Schema","parameters":[{"description":"To get unique article for article Id units.","in":"path","name":"articleId","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Article response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Article-Units"},"examples":{"response":{"value":[{"available":false,"id":"TC021A00J-A110040000","originalPrice":{"currency":"GBP","formatted":"£130.00","value":130},"price":{"currency":"GBP","formatted":"£65.00","value":65},"size":"14","stock":0}]}}}}},"400":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"Get Article units by articleId","tags":["articles"]}},"/articles/{articleId}/units/{unitId}":{"get":{"description":"Zalando API Article Schema","parameters":[{"description":"To get unique article for article Id.","in":"path","name":"articleId","required":true,"schema":{"type":"string"}},{"description":"To get unique article for article Id unit.","in":"path","name":"unitId","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Article response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Article-Unit"},"examples":{"response":{"value":{"available":false,"id":"TC021A00J-A110040000","originalPrice":{"currency":"GBP","formatted":"£130.00","value":130},"price":{"currency":"GBP","formatted":"£65.00","value":65},"size":"14","stock":0}}}}}},"400":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"Get Article units by articleId snd unitId","tags":["articles"]}},"/brands":{"get":{"description":"Zalando API Brands Schema","parameters":[{"description":"Request Brand by key","in":"query","name":"key","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Request Brand by name","in":"query","name":"name","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Request Brand by brandFamilyName","in":"query","name":"brandFamilyName","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Request Brand by brandFamilyKey","in":"query","name":"brandFamilyKey","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"$ref":"#/components/parameters/page"},{"$ref":"#/components/parameters/pageSize"},{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Brands response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Brands"},"examples":{"response":{"value":{"content":[{"key":"NV3","name":"Nike Vision","shopUrl":"https://www.zalando.co.uk/nike-vision"},{"brandFamily":{"key":"NIKE","name":"Nike","shopUrl":"https://www.zalando.co.uk/nike"},"key":"N12","logoLargeUrl":"https://i1.ztat.net/brandxl/nike-performance.jpg","logoUrl":"https://i1.ztat.net/brand/nike-performance.jpg","name":"Nike Performance","shopUrl":"https://www.zalando.co.uk/nike-performance"}],"page":1,"size":2,"totalElements":6,"totalPages":3}}}}}},"400":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"Shop Brands","tags":["brands"]}},"/brands/{key}":{"get":{"description":"Zalando API Brand Schema","parameters":[{"description":"To get unique Brand by key.","in":"path","name":"key","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Brand Key response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Brand"},"examples":{"response":{"value":{"brandFamily":{"key":"NIKE","name":"Nike","shopUrl":"https://www.zalando.co.uk/nike"},"key":"N12","logoLargeUrl":"https://i1.ztat.net/brandxl/nike-performance.jpg","logoUrl":"https://i1.ztat.net/brand/nike-performance.jpg","name":"Nike Performance","shopUrl":"https://www.zalando.co.uk/nike-performance"}}}}}},"404":{"description":"Brand not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"Get Single Brand by Key","tags":["brands"]}},"/categories":{"get":{"description":"Zalando API Categories Schema","parameters":[{"description":"Request Categories by names","in":"query","name":"name","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Request Categories by type","in":"query","name":"type","required":false,"explode":true,"schema":{"type":"string"}},{"description":"Request Categories by outlet","in":"query","name":"outlet","required":false,"explode":true,"schema":{"type":"string"}},{"description":"Request Categories by hidden","in":"query","name":"hidden","required":false,"explode":true,"schema":{"type":"string"}},{"description":"Request Categories by target group","in":"query","name":"targetGroup","required":false,"explode":true,"schema":{"type":"string"}},{"description":"Request Categories by keys","in":"query","name":"key","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Request Categories by parent keys","in":"query","name":"parentKey","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Request Categories by child keys","in":"query","name":"childKey","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Request Categories by suggested filters","in":"query","name":"suggestedFilter","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"$ref":"#/components/parameters/page"},{"$ref":"#/components/parameters/pageSize"},{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Categories response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Categories"},"examples":{"response":{"value":{"content":[{"childKeys":["all","women","men","kids","home"],"hidden":false,"key":"catalog","name":"Catalog","outlet":false,"suggestedFilters":["category","brand","color","price","activationDate"],"targetGroup":"ALL","type":"default"},{"childKeys":["womens-shoes","womens-clothing","sports-womens","premium-womens"],"hidden":false,"key":"women","name":"Women","outlet":false,"parentKey":"catalog","suggestedFilters":["brandfamily","sale","upperMaterial","season"],"targetGroup":"WOMEN","type":"default"}],"page":1,"size":2,"totalElements":2263,"totalPages":1132}}}}}},"400":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"404":{"description":"Categories Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"Shop Categories","tags":["categories"]}},"/categories/{key}":{"get":{"description":"Zalando API Category Schema","parameters":[{"description":"To get unique Category by key.","in":"path","name":"key","required":true,"style":"simple","schema":{"type":"array","items":{"type":"string"}}},{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Category Key response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Category"},"examples":{"response":{"value":{"content":[{"childKeys":["womens-shoes","womens-clothing","sports-womens","premium-womens"],"hidden":false,"key":"women","name":"Women","outlet":false,"parentKey":"catalog","targetGroup":"WOMEN","type":"default"}]}}}}}},"404":{"description":"Category not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"Get Single Category by Key","tags":["categories"]}},"/domains":{"get":{"description":"Zalando API Domains Schema","responses":{"200":{"description":"Domains response.","content":{"application/json":{"schema":{"description":"Zalando API Domains Schema","items":{"$ref":"#/components/schemas/Domain"},"type":"array"}}}}},"summary":"Shop Domains","tags":["domains"]}},"/facets":{"get":{"description":"Zalando API Facets Schema","parameters":[{"$ref":"#/components/parameters/ageGroup"},{"$ref":"#/components/parameters/articleId"},{"$ref":"#/components/parameters/activationDate"},{"$ref":"#/components/parameters/articleModelId"},{"$ref":"#/components/parameters/assortmentArea"},{"$ref":"#/components/parameters/brand"},{"$ref":"#/components/parameters/brandfamily"},{"$ref":"#/components/parameters/category"},{"$ref":"#/components/parameters/color"},{"$ref":"#/components/parameters/den"},{"$ref":"#/components/parameters/filling"},{"$ref":"#/components/parameters/gender"},{"$ref":"#/components/parameters/heelForm"},{"$ref":"#/components/parameters/heelHeight"},{"$ref":"#/components/parameters/length"},{"$ref":"#/components/parameters/occasion"},{"$ref":"#/components/parameters/pattern"},{"$ref":"#/components/parameters/price"},{"$ref":"#/components/parameters/sale"},{"$ref":"#/components/parameters/season"},{"$ref":"#/components/parameters/shaftHeight"},{"$ref":"#/components/parameters/shaftWidth"},{"$ref":"#/components/parameters/shirtCollar"},{"$ref":"#/components/parameters/shoeFastener"},{"$ref":"#/components/parameters/shoeToecap"},{"$ref":"#/components/parameters/shopArea"},{"$ref":"#/components/parameters/size"},{"$ref":"#/components/parameters/sports"},{"$ref":"#/components/parameters/technology"},{"$ref":"#/components/parameters/trouserRise"},{"$ref":"#/components/parameters/upperMaterial"},{"$ref":"#/components/parameters/volume"},{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Facets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Facets"},"examples":{"response":{"value":[{"facets":[{"count":2080,"displayName":"Sports Shoes","key":"childrens-sports-shoes"},{"count":273,"displayName":"Outdoor Shoes","key":"childrens-outdoor-shoes"},{"count":1365,"displayName":"Sandals & Flip Flops","key":"kids-shoes-sandals-flip-flops"}],"filter":"category"},{"facets":[{"count":190247,"displayName":"female","key":"female"},{"count":117211,"displayName":"male","key":"male"}],"filter":"gender"},{"facets":[{"count":17844,"displayName":"allSeason","key":"allSeason"},{"count":155667,"displayName":"summer","key":"summer"},{"count":116763,"displayName":"winter","key":"winter"}],"filter":"season"}]}}}}},"400":{"description":"Bad request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"Shop Facets","tags":["facets"]}},"/filters":{"get":{"description":"Zalando API Filters Schema","parameters":[{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Filters response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Filters"},"examples":{"response":{"value":[{"multiValue":true,"name":"ageGroup","type":"ENUM","values":[{"displayName":"babies","key":"babies"},{"displayName":"kids","key":"kids"},{"displayName":"teen","key":"teen"},{"displayName":"adult","key":"adult"}]},{"multiValue":true,"name":"brand","type":"KEY","values":[]}]}}}}}},"summary":"Shop Filters","tags":["filters"]}},"/filters/{filterName}":{"get":{"description":"Zalando API Filters Schema","parameters":[{"description":"To get Filter by filterName.","in":"path","name":"filterName","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Filters response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Filter"},"examples":{"response":{"value":{"multiValue":true,"name":"ageGroup","type":"ENUM","values":[{"displayName":"babies","key":"babies"},{"displayName":"kids","key":"kids"},{"displayName":"teen","key":"teen"},{"displayName":"adult","key":"adult"}]}}}}}},"404":{"description":"Filter not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"Get Single Filter by filterName","tags":["filters"]}},"/recommendations/{articleIds}":{"get":{"description":"Zalando API Recommendations Schema","parameters":[{"description":"To get Recommendations by articleIds.","in":"path","name":"articleIds","required":true,"style":"simple","schema":{"type":"array","items":{"type":"string"}}},{"description":"To get maximum results of Recommendations by articleId.","in":"query","name":"maxResults","required":false,"schema":{"type":"string"}},{"$ref":"#/components/parameters/acceptLanguage"},{"$ref":"#/components/parameters/fields"}],"responses":{"200":{"description":"Recommendations response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Recommendations"},"examples":{"response":{"value":{"id":"TC021A00J-A11","media":{"images":[{"largeHdUrl":"https://i5.ztat.net/large_hd/TC/02/1A/00/JA/11/TC021A00J-A11@12.jpg","largeUrl":"https://i5.ztat.net/large/TC/02/1A/00/JA/11/TC021A00J-A11@12.jpg","mediumHdUrl":"https://i5.ztat.net/detail_hd/TC/02/1A/00/JA/11/TC021A00J-A11@12.jpg","mediumUrl":"https://i5.ztat.net/detail/TC/02/1A/00/JA/11/TC021A00J-A11@12.jpg","orderNumber":1,"smallHdUrl":"https://i5.ztat.net/catalog_hd/TC/02/1A/00/JA/11/TC021A00J-A11@12.jpg","smallUrl":"https://i5.ztat.net/catalog/TC/02/1A/00/JA/11/TC021A00J-A11@12.jpg","thumbnailHdUrl":"https://i5.ztat.net/thumb_hd/TC/02/1A/00/JA/11/TC021A00J-A11@12.jpg","type":"UNSPECIFIED"}]},"modelId":"TC021A00J","name":"MADDY - Jumpsuit - waterlilly/noir","shopUrl":"https://www.zalando.co.uk/2-love-tony-cohen-maddy-jumpsuit-white-tc021a00j-a11.html"}}}}}},"400":{"description":"Bad Request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"Get Recommendations by articleId","tags":["recommendations"]}}},"servers":[{"url":"https://api.zalando.com"}],"components":{"parameters":{"acceptLanguage":{"description":"Specify which Shop to use.\n\nA standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the German\nshop (as does [https://www.zalando.de](https://www/zalando.de) and `de-AT` will use the Austrian one.\n\nThe shop choosen will e.g. define the currency used for prices as well as the language for product names and\ndescriptions. Furthermore it will impact which articles are available as they might differ between countries.","in":"header","name":"Accept-Language","required":false,"schema":{"type":"string","enum":["da-DK","de-AT","de-CH","de-DE","en-GB","es-ES","fi-FI","fr-BE","fr-CH","fr-FR","it-IT","nl-BE","nl-NL","no-NO","pl-PL","sv-SE"]}},"activationDate":{"description":"period or time the articles are activated for selling in the shop","in":"query","name":"activationDate","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["thisWeek","lastWeek","lastMonth"],"type":"string"}}},"ageGroup":{"description":"filters by age group (eg: kids)","in":"query","name":"ageGroup","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["babies","kids","teen","adult"],"type":"string"}}},"articleId":{"description":"The `articleIds` to use use for filtering.\n\nOne or more `articleIds` might be used as a filter criteria. Submit multiple `articleId` request parameters for\nmore than one to be used. They will be treated as `OR` criteria.","in":"query","name":"articleId","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},"articleModelId":{"description":"filters by article ModelId","in":"query","name":"articleModelId","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},"articleReviewSort":{"description":"articles are sorted on reviews provided by customers (eg: best)","in":"query","name":"sort","required":false,"schema":{"type":"string","enum":["newest","best","worst","most_helpful"],"default":"newest"}},"articleUnitId":{"description":"filters by article's unit id","in":"query","name":"articleUnitId","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},"assortmentArea":{"description":"filters by classification of articles (eg: maternity) ","in":"query","name":"assortmentArea","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["standard","maternity","plusSize","petite"],"type":"string"}}},"brand":{"description":"filters by brand key given by user (eg: SA5)","in":"query","name":"brand","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},"brandfamily":{"description":"filters by brand family key (eg: nike) ","in":"query","name":"brandfamily","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},"category":{"description":"filters by category (eg: Socks, Rain Coats)","in":"query","name":"category","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},"color":{"description":"filters by color (eg: red, blue)","in":"query","name":"color","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["black","brown","beige","gray","white","blue","petrol","turquoise","green","olive","yellow","orange","red","pink","purple","gold","silver","multicolored"],"type":"string"}}},"den":{"description":"filters by den ","in":"query","name":"den","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["den15","den20","den40","den60","den80","den100","den200","den120","den12","den50"],"type":"string"}}},"fields":{"description":"Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects within lists are specified in the same way.\n\nExample: id,name,brand.key,brand.name, units.id,units.size,units.price.formatted","in":"query","name":"fields","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},"filling":{"description":"filters by different kinds of garment filling materials (eg: satin, wolle)","in":"query","name":"filling","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["angora","baumwolle","daunen","fell","fleece","frottee","kaschmir","lammfell","leder","lederimitat","merinowolle","microfaser","mohair","satin","schurwolle","seide","sonstige","textil","warm","wolle"],"type":"string"}}},"fullText":{"description":"filters by text (eg: search by 'as' gives result with articles of brand Sass)","in":"query","name":"fullText","required":false,"schema":{"type":"string"}},"gender":{"description":"filters by gender","in":"query","name":"gender","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["male","female"],"type":"string"}}},"heelForm":{"description":"filters by heel form (eg: flat)","in":"query","name":"heelForm","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["block","flat","wedge","penny","funnel","plateau","plateauBoots","wedgeHidden","plateauHidden","plateauHeels"],"type":"string"}}},"heelHeight":{"description":"filters by height of the heel size or length (eg: xs)","in":"query","name":"heelHeight","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["xs","s","m"],"type":"string"}}},"length":{"description":"filters by garments length (eg: 3/4 length, knee-length)","in":"query","name":"length","required":false,"schema":{"type":"string"}},"maxStarRating":{"description":"To get reviews with maximum star rating.","in":"query","name":"maxStarRating","required":false,"schema":{"type":"string"}},"minStarRating":{"description":"To get reviews with minimum star rating.","in":"query","name":"minStarRating","required":false,"schema":{"type":"string"}},"occasion":{"description":"filters by type of occasion (eg: party, business)","in":"query","name":"occasion","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["business","octoberFest","loungeWear","evening","party","leisure"],"type":"string"}}},"page":{"description":"to request with required page number or pagination","in":"query","name":"page","required":false,"schema":{"type":"string"}},"pageSize":{"description":"to request with required page size in a page","in":"query","name":"pageSize","required":false,"schema":{"type":"string"}},"pattern":{"description":"filters by pattern on the garments (eg: animal print, plain)","in":"query","name":"pattern","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["animalPrint","checkered","colored","floral","polkaDot","striped","paisley","plain","print","burnout","herringBone","camouflage","flecked","pinstripe","gradient","photoPrint"],"type":"string"}}},"price":{"description":"filters all articles in price range (eg: 9-90)","in":"query","name":"price","required":false,"schema":{"type":"string"}},"sale":{"description":"filters discounted articles marked as sale","in":"query","name":"sale","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"enum":["sale"],"type":"string"}}},"season":{"description":"filters by season (Autumn/Winter or Spring/Summer)","in":"query","name":"season","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["winter","summer"],"type":"string"}}},"shaftHeight":{"description":"filters by shaft height (eg: s, xs)","in":"query","name":"shaftHeight","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["xs","s","m","l"],"type":"string"}}},"shaftWidth":{"description":"filters by shaft width (eg: s, l)","in":"query","name":"shaftWidth","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["s","m","l"],"type":"string"}}},"shirtCollar":{"description":"filters by shirt collar styles (eg: low V neck, lined collar)","in":"query","name":"shirtCollar","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["lapelCollar","mandarinCollar","hood","poloNeck","poloShirt","cowlNeck","roundNeck","scarfCollar","boatNeck","vNeck","buttonDown","turnDownCollar","highCollar","linedCollar","shirtCollar","cutawayCollar","doubleCollar","peterPanCollar","kentCollar","cupShapedCollar","contrastCollar","maoCollar","wingCollar","tabCollar","volantCollar","shawlCollar","envelope","lowVNeck","cacheCeour","lowRoundNeck","backless","henley","squareNeck","offTheShoulder"],"type":"string"}}},"shoeFastener":{"description":"filters by shoe fastener types (eg: buckle, lacing)","in":"query","name":"shoeFastener","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["buckle","belt","lacing","open","zipper","velcro"],"type":"string"}}},"shoeToecap":{"description":"filters by shoe toe cap variants (eg: pointed, square)","in":"query","name":"shoeToecap","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["round","pointed","open","square"],"type":"string"}}},"shopArea":{"description":"filters by classification of articles","in":"query","name":"shopArea","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["shop","sale"],"type":"string"}}},"size":{"description":"filters by size","in":"query","name":"size","required":false,"schema":{"type":"string"}},"sort":{"description":"sorting order (eg: popularity)","in":"query","name":"sort","required":false,"schema":{"type":"string","enum":["popularity","activationdate","pricedesc","priceasc","sale"]}},"sports":{"description":"filters by different sport activities (eg: football)","in":"query","name":"sports","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["outdoor","skiSnow","running","training","football","handball","basketball","volleyball","golf","tennis","beach","skate","riding","cycling","sailing","badminton","dancing","snowboard","swimming"],"type":"string"}}},"technology":{"description":"filters by technology used to produce the articles","in":"query","name":"technology","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["clima365","climacool","climalite","climaproof","climawarm","driFit","flywire","formotion","omniHeat","polartec","primaloft","staywarm","techfit","thinsulate","venturi","h2no","dermizax","performanceShell","softShell","windstopper","proShell","hydratic","pacliteShell","activeShell","goreTex","hyvent","texapore","precip"],"type":"string"}}},"trouserRise":{"description":"filters by trouser rise","in":"query","name":"trouserRise","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["high","medium","low"],"type":"string"}}},"upperMaterial":{"description":"filters by different type of upper material used on garments (eg: lace)","in":"query","name":"upperMaterial","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["batiste","caoutchouc","cashmere","damask","down","feathers","felt","flanelette","flannel","fleece","imitationLeather","jacquard","jersey","leather","linen","linon","mesh","microfiber","mohair","other","percale","polyester","renforce","satin","seersucker","silk","synthetic","textile","towelling","varnish","velours","viscose","wool","cord","denim","rib","braided","crocheted","hardshell","softshell","lace","sweat"],"type":"string"}}},"volume":{"description":"filters by volume","in":"query","name":"volume","required":false,"explode":true,"schema":{"type":"array","items":{"enum":["smallest","small","medium","large","largest"],"type":"string"}}}},"schemas":{"Article":{"description":"A single article","properties":{"activationDate":{"description":"timestamp the article was available in the Zalando webshop","format":"date-time","type":"string"},"additionalInfos":{"description":"any additional information of the article ","items":{"type":"string"},"minItems":0,"type":"array"},"ageGroups":{"description":"age group of the article belongs to","items":{"enum":["BABY","CHILD","TEEN","ADULT"],"type":"string"},"minItems":1,"type":"array"},"attributes":{"description":"article attributes","items":{"$ref":"#/components/schemas/Article-Attribute"},"minItems":0,"type":"array"},"available":{"description":"will be true if at least one article unit is available","type":"boolean"},"brand":{"$ref":"#/components/schemas/Brand"},"categoryKeys":{"description":"category keys of the article belongs to","items":{"type":"string"},"minItems":1,"type":"array"},"color":{"description":"the main color of the article","type":"string"},"genders":{"description":"gender of the article belongs to","items":{"enum":["MALE","FEMALE"],"type":"string"},"minItems":1,"type":"array"},"id":{"description":"unique article id","type":"string"},"media":{"$ref":"#/components/schemas/Article-Media"},"modelId":{"description":"unique article model id","type":"string"},"name":{"description":"article name","type":"string"},"season":{"description":"collection season the article belongs to","enum":["SUMMER","WINTER","ALL"],"type":"string"},"seasonYear":{"description":"collection year the article belongs to. Could be either a year or 'ALL'","pattern":"^ALL$|^20[0-9]{2}$","type":"string"},"shopUrl":{"description":"url of the article within the Zalando webshop","format":"uri","type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"units":{"description":"price of the article","items":{"$ref":"#/components/schemas/Article-Unit"},"minItems":1,"type":"array"}},"required":["id","modelId","name","shopUrl","color","available","season","seasonYear","activationDate","additionalInfos","genders","ageGroups","brand","categoryKeys","attributes","units","media"],"type":"object"},"Article-Attribute":{"description":"Zalando API Article Attribute Schema","properties":{"name":{"description":"name of the article attribute","type":"string"},"values":{"description":"value of the article attribute","items":{"type":"string"},"minItems":1,"type":"array"}},"required":["name","values"],"type":"object"},"Article-Image":{"description":"Zalando API Article Image Schema","properties":{"largeHdUrl":{"description":"large HD image of the article","format":"uri","type":"string"},"largeUrl":{"description":"large image of the article","format":"uri","type":"string"},"mediumHdUrl":{"description":"medium HD image of the article","format":"uri","type":"string"},"mediumUrl":{"description":"medium image of the article","format":"uri","type":"string"},"orderNumber":{"description":"sequence of the article images","type":"integer"},"smallHdUrl":{"description":"small HD image of the article","format":"uri","type":"string"},"smallUrl":{"description":"small image of the article","format":"uri","type":"string"},"thumbnailHdUrl":{"description":"thumbnail HD url of the article images","format":"uri","type":"string"},"type":{"description":"model or non model type article images","type":"string"}},"required":["orderNumber","type","thumbnailHdUrl","smallUrl","smallHdUrl","mediumUrl","mediumHdUrl","largeUrl","largeHdUrl"],"type":"object"},"Article-Media":{"description":"Zalando API Article Media Schema","properties":{"images":{"items":{"$ref":"#/components/schemas/Article-Image"},"minItems":0,"type":"array"}},"required":["images"],"type":"object"},"Article-Price":{"description":"Zalando API Article Price Schema",