---
title: "List Hermès stores"
method: GET
path: "/hermes/stores"
tags: ["Hermes"]
---

# List Hermès stores

`GET /hermes/stores`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/hermes/stores`
- Auth: API key in header `x-api-key`

Returns Hermès' worldwide store directory: name, street address, city, postal code, country, geographic coordinates, phone, displayed opening hours, whether in-store appointments are offered, and store photos. Optionally narrowed to one country (by name or ISO-2 code) or city. Hermès publishes the same worldwide directory for every market, so locale selects the language names are returned in rather than which stores are listed.

## Query parameters

- `locale` 'at_de' | 'au_en' | 'be_en' | 'be_fr' | 'br_pt' | 'ca_en' | 'ca_fr' | 'ch_de' | 'ch_fr' | 'cz_en' | 'de_de' | 'dh_en' | 'dk_en' | 'es_es' | 'fi_en' | 'fr_fr' | 'gr_en' | 'hk_en' | 'ie_en' | 'it_it' | 'jp_ja' | 'kr_ko' | 'lu_fr' | 'mo_en' | 'mx_es' | 'my_en' | 'nl_en' | 'no_en' | 'pl_en' | 'pt_en' | 'ri_en' | 'se_en' | 'sg_en' | 'th_en' | 'tw_zh' | 'uk_en' | 'us_en'
- `country` string
- `city` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- HermesStoresResponseDoc
  - `code` integer
  - `data` HermesStoresResponse
    - `locale` string
    - `stores` HermesStore[]
      - `appointment_in_store` boolean
      - `city` string
      - `continent` string
      - `country` string
      - `country_code` string
      - `id` string
      - `images` string[]
      - `latitude` number
      - `longitude` number
      - `name` string
      - `opening_hours` string
      - `phone` string
      - `postal_code` string
      - `street` string
      - `url` string
    - `total` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)