Garde-Robe public API
A small, read-only part of the Garde-Robe gateway answers anyone, with no account and no key: a health check, the day’s exchange rates, and the catalogue behind our brand pages. Nothing in it identifies a member.
Before you start
- Base URL:
https://services.garde-robe.com - No sign-in, token or API key is needed. Every endpoint below answers a plain GET.
- Responses are JSON, except a product image, which redirects to the image.
- An error is JSON shaped like
{"error":{"code":"…","message":"…"}}. - The machine-readable description is an OpenAPI 3.1 file: https://www.garde-robe.com/openapi.json.
- Check that the gateway is up: https://services.garde-robe.com/v1/health.
- Product
clickUrllinks are for people who want to shop: following one is a visit, and our robots.txt asks automated clients not to. UseproductUrlordestinationUrlto reach the retailer.
Check gateway health
GET /v1/health
Answers 200 with status: ok while the gateway is running. The response is never cached.
Example request
curl "https://services.garde-robe.com/v1/health"Example response
{
"status": "ok",
"version": "v1",
"environment": "production"
}Responses
200The gateway is up.
Get the day's reference exchange rates
GET /v1/fx-rates
Units of each currency per one US dollar, from the European Central Bank's reference rates (via Frankfurter), refreshed once each working day. Use it to show a price approximately in the reader's own currency; never for payment. To convert an amount in currency A to currency B, divide by rates[A] and multiply by rates[B]. A currency missing from rates has no conversion.
Example request
curl "https://services.garde-robe.com/v1/fx-rates"Example response
{
"base": "USD",
"date": "2026-11-18",
"source": "ecb-frankfurter",
"rates": {
"USD": 1,
"CAD": 1.4305,
"EUR": 0.91174,
"GBP": 0.75939,
"JPY": 159.42
}
}Responses
200The latest stored table of rates.503No table is stored and the source could not be read.
List every brand that has a public brand page
GET /v1/public/brands
Brands with enough products that members have saved publicly, largest first. A saved product counts only when it was saved publicly: saves restricted to a private wishlist never count. The answer is the same for every caller and the list is long, so read it once and keep it.
Example request
curl "https://services.garde-robe.com/v1/public/brands"Example response
{
"brands": [
{
"slug": "zara",
"displayName": "Zara",
"productCount": 1019,
"shopProductCount": 0,
"lastSavedAt": "2026-11-16T20:32:01.210289+00:00",
"affiliate": false
},
{
"slug": "free-people",
"displayName": "Free People",
"productCount": 574,
"shopProductCount": 6047,
"lastSavedAt": "2026-11-17T16:10:53.377206+00:00",
"affiliate": true
}
]
}Responses
200Brands with a public page.503The catalogue could not be read.
Read one brand's products
GET /v1/public/brands/{slug}
One page of the products members have saved publicly for this brand, newest save first, and one page of the brand's in-stock shop products. Each product appears once however many members saved it, and carries product facts only: nothing identifies, or was written by, the members who saved it. Any hyphenation of the same letters reaches the same brand; when the requested slug differs from brand.slug, use the canonical slug the response carries.
Parameters
slugin the path, required- The brand slug, as listed by
/v1/public/brands. pagein the query, optional- 1-based page number of member products and of shop products.
pageSizein the query, optional- Member products per page. A page can hold slightly fewer, because repeated titles are shown once.
Example request
curl "https://services.garde-robe.com/v1/public/brands/free-people?pageSize=1"Example response
{
"brand": {
"slug": "free-people",
"displayName": "Free People",
"productCount": 574,
"shopProductCount": 5876,
"lastSavedAt": "2026-11-17T16:10:53.377206+00:00",
"affiliate": true
},
"indexable": true,
"products": [
{
"productId": "407d362c-5063-4081-92d1-9b4802b05930",
"title": "Breezy Plaid Midi Skirt Set",
"priceCents": 22800,
"currency": "USD",
"availability": "in_stock",
"productUrl": "https://www.freepeople.com/shop/breezy-plaid-midi-skirt-set",
"saveCount": 1,
"lastSavedAt": "2026-11-17T16:10:53.377206+00:00",
"clickUrl": "https://services.garde-robe.com/v1/public/brand-products/407d362c-5063-4081-92d1-9b4802b05930/click",
"image": {
"url": "https://services.garde-robe.com/v1/public/brand-images/a1dd796f-e1ed-4056-baf1-e5fc4457b1a2",
"width": 640,
"height": 960
}
}
],
"page": 1,
"pageSize": 1,
"hasMore": true,
"shopProducts": [
{
"id": "1326d3c1-18f6-4557-a1ae-833856f46b73",
"title": "Boxing Day Lace Up Boots",
"destinationUrl": "https://www.freepeople.com/shop/boxing-day-lace-up-boots/?color=023&size=US+10&type=STANDARD",
"brand": "Free People",
"priceCents": 17800,
"category": "Apparel & Accessories",
"imageUrl": "https://images.urbndata.com/is/image/FreePeople/87038972_023_a?$feed-main$",
"clickUrl": "https://services.garde-robe.com/v1/public/brand-products/1326d3c1-18f6-4557-a1ae-833856f46b73/click"
}
],
"shopHasMore": true
}Responses
200A page of the brand's products.400The slug,pageorpageSizeis not valid.404No brand has this slug.503The catalogue could not be read.
Fetch a product image shown on a brand page
GET /v1/public/brand-images/{assetId}
The stable, unsigned address of a product image: every image.url in a brand page response points here. It answers with a redirect to the image CDN, or with the image itself. An image is served only while it belongs to at least one product shown on a public brand page; otherwise the answer is 404.
Parameters
assetIdin the path, required- The image id, the last segment of an
image.url.
Example request
curl "https://services.garde-robe.com/v1/public/brand-images/a1dd796f-e1ed-4056-baf1-e5fc4457b1a2"Responses
200The image.302Redirect to the image CDN.400The image id is not a valid id.404The image is not on a public brand page.503The catalogue could not be read.
Questions about the API? Email hi@garde-robe.com.