---
title: "GET /consumer-spending/eu/v1/merchant-hierarchy"
method: GET
path: "/consumer-spending/eu/v1/merchant-hierarchy"
tags: ["fable"]
---

# GET /consumer-spending/eu/v1/merchant-hierarchy

`GET /consumer-spending/eu/v1/merchant-hierarchy`

Reference data mapping merchants to parent companies, tickers, sectors, and industries across Fable's European consumer transaction panel. Each row represents a single merchant with its corporate hierarchy and classification metadata. Weekly snapshots contain ~3,500 merchants covering ~250 US public companies. Use lookup_name to join with the name field from the merchant-aggregates endpoint, filtering by active_from and active_to to match a specific transaction_date (e.g., active_from.lte=2025-06-15&active_to.gte=2025-06-15).

## Query parameters

- `lookup_name` string
- `lookup_name.any_of` string
- `lookup_name.gt` string
- `lookup_name.gte` string
- `lookup_name.lt` string
- `lookup_name.lte` string
- `ticker` string
- `ticker.any_of` string
- `ticker.gt` string
- `ticker.gte` string
- `ticker.lt` string
- `ticker.lte` string
- `listing_status` 'public' | 'private'
- `listing_status.any_of` 'public' | 'private'
- `active_from` string
- `active_from.gt` string
- `active_from.gte` string
- `active_from.lt` string
- `active_from.lte` string
- `active_to` string
- `active_to.gt` string
- `active_to.gte` string
- `active_to.lt` string
- `active_to.lte` string
- `limit` integer
- `sort` string

## Response `200`

A list of results.

- object
  - `next_url` string — If present, this value can be used to fetch the next page.
  - `request_id` string, required — A request id assigned by the server.
  - `results` object[], required — The results for this request.
    - `active_from` string, date — Date this merchant hierarchy mapping became applicable. A value of 0001-01-01 indicates no known start date. Use with active_to to match against transaction_date from the merchant-aggregates endpoint to perform point-in-time queries.
    - `active_to` string, date — Date after which this merchant hierarchy mapping is no longer applicable due to a corporate action. A value of 9999-12-31 indicates the mapping is currently active.
    - `category` string — Merchant category assigned by the data provider (Title Case, e.g., 'Groceries', 'General Merchandise', 'Travel'). Values are managed by the data provider and may expand over time.
    - `grandparent_name` string — Merchant's grandparent business name (Title Case).
    - `grandparent_ticker` string — Stock ticker of the merchant's grandparent company. Uses Bloomberg standard.
    - `great_grandparent_name` string — Merchant's great-grandparent business name (Title Case, top-level corporate entity).
    - `great_grandparent_ticker` string — Stock ticker of the merchant's great-grandparent company (top-level corporate entity). Uses Bloomberg standard.
    - `industry` string — Industry classification based on GICS/BICS/ICB standards.
    - `industry_group` string — Industry group classification based on GICS/BICS/ICB standards.
    - `listing_status` string, required — Whether the merchant is a publicly listed company or private. Possible values: public, private.
    - `lookup_name` string — Lowercase merchant tag used for joining with the merchant-aggregates endpoint name field (e.g., 'asda', 'amazon').
    - `normalized_name` string — Cleaned, standardized merchant display name (Title Case, e.g., 'Asda', 'Amazon').
    - `parent_name` string — Merchant's parent business name (Title Case). Useful for aggregating transactions across subsidiary brands.
    - `parent_ticker` string — Stock ticker of the merchant's parent company. Uses Bloomberg standard.
    - `sector` string — Sector classification based on GICS/BICS/ICB standards.
    - `sub_industry` string — Sub-industry classification based on GICS/BICS/ICB standards.
    - `ticker` string — Stock ticker associated with the merchant (~250 US public companies mapped). Uses Bloomberg standard.
  - `status` 'OK', required — The status of this request's response.

## Other responses

- `400` — An error message.

---

[API](https://skmtc.net/massive/apis/polygon-api.md) · [All operations](https://skmtc.net/massive/apis/polygon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/massive/polygon-api/revisions/ad6f143e43aa/schema)