---
title: "Get information about this retailer"
method: GET
path: "/retailer"
tags: ["Retailers"]
---

# Get information about this retailer

`GET /retailer`

This endpoint returns information about the retailer.

🔒 Requires: `retailer:read` `payment_types:read` scopes

## Response `200`

OK

- RetailerResponse — A Retailer record wrapped in the top-level data object.
  - `data` Retailer — A Retailer record.
    - `account_status` string — Status of this account.
    - `account_type` string — Type of this account.
    - `activated_at` string, nullable — Activation timestamp, e.g. '2019-08-15T23:05:28Z'. This field can be null, e.g. for 'demo' retailers.
    - `country` string — 2-letter country code for this Retailer.
    - `created_at` string — Creation timestamp, e.g. '2019-08-15T23:05:28Z'
    - `culture` string — Culture (language name) for this Retailer.
    - `currency` RetailerCurrency
      - `code` string — 3-letter Currency Code for this Retailer.
      - `symbol` string — Currency Symbol for this Retailer.
    - `discount_product_id` string, uuid — A reference to the default discount product used for sale-level discounts.
    - `domain_prefix` string — The subdomain of vendhq.com for this retailer.
    - `gift_cards` object
      - `enabled` boolean — Whether the Retailer has enabled Gift Cards.
      - `never_enabled` boolean — Whether the Retailer has _never_ had Gift Cards enabled. Can be used to indicate whether historical Gift Card data exists.
    - `id` string, uuid — Auto-generated object ID.
    - `loyalty` object
      - `claim_url` string — URL for this Retailer's Loyalty plan.
      - `enabled` boolean — Whether Loyalty has been enabled.
      - `ratio` number — Ratio of Loyalty Points.
      - `send_welcome_email` boolean — Denotes Whether the Retailer's Loyalty plan is configured to send Welcome emails.
    - `name` string — Unique name for this Retailer.
    - `no_tax_group_id` string, uuid — A reference to the default 0% rate tax used for tax-free line items.
    - `sku_sequence` object
      - `enabled` boolean — Whether the Retailer has enabled auto-generation of SKUs, in a numeric sequence.
      - `value` integer — The current value of the auto-generated SKU.
    - `store_credit` boolean — Whether the Retailer has enabled Store Credit.
    - `store_url` string — URL for the store itself.
    - `tax_exclusive` boolean — Whether Prices should be interpreted as Tax-Exclusive.
    - `timezone` string — Default Timezone for retailer - e.g. Pacific/Auckland. NOTE: timezones can vary between Outlets.
    - `version` string — Auto-incrementing object version number.

---

[API](https://skmtc.net/lightspeedhq/apis/api-2026-07.md) · [All operations](https://skmtc.net/lightspeedhq/apis/api-2026-07/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightspeedhq/api-2026-07/revisions/72d4ceb46dbb/schema)