Skip to content

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 clickUrl links are for people who want to shop: following one is a visit, and our robots.txt asks automated clients not to. Use productUrl or destinationUrl to 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

  • 200 The 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

  • 200 The latest stored table of rates.
  • 503 No 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

  • 200 Brands with a public page.
  • 503 The 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

slug in the path, required
The brand slug, as listed by /v1/public/brands.
page in the query, optional
1-based page number of member products and of shop products.
pageSize in 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

  • 200 A page of the brand's products.
  • 400 The slug, page or pageSize is not valid.
  • 404 No brand has this slug.
  • 503 The 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

assetId in 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

  • 200 The image.
  • 302 Redirect to the image CDN.
  • 400 The image id is not a valid id.
  • 404 The image is not on a public brand page.
  • 503 The catalogue could not be read.

Questions about the API? Email hi@garde-robe.com.