Skip to main content
GET
Get one physical store

Authorizations

X-API-Key
string
header
required

Path Parameters

retailer_id
string<shortuuid>
required

Unique identifier of the retailer this store belongs to.

Required string length: 22
Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$
store_id
string<shortuuid>
required

Unique identifier of the store.

Required string length: 22
Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$

Response

OK

One physical store as the catalog holds it.

The retailer-owned columns plus a flattened copy of the store's locations.Place address, because a caller reconciling its own dataset against ours needs the address to compare against and should not have to follow a second identifier into another app's API to get it.

id
string<shortuuid>
required

URL-safe 22-character shortuuid encoding of the row's UUID primary key. Stable across the row's lifetime; suitable for sharing in URLs, log lines, and external SDK clients. Accepted on input as either the shortuuid form or the canonical UUID form (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).

Required string length: 22
Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$
retailer_id
string<shortuuid>
required

URL-safe 22-character shortuuid encoding of the row's UUID primary key. Stable across the row's lifetime; suitable for sharing in URLs, log lines, and external SDK clients. Accepted on input as either the shortuuid form or the canonical UUID form (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).

Required string length: 22
Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$
name
string
required

Store or branch display name.

store_number
string
required

The retailer's own key for this store, or the synthesized key the import recorded. Unique within a retailer when non-empty, and the highest-confidence tier the store upsert matches on.

is_active
boolean
required

False for a retired store. DELETE clears this flag rather than removing the row, so a deleted store still appears in this list unless you filter it out with is_active=true.

place_id
string<shortuuid>
required

Identifier of the locations.Place this store occupies — the geographic record.

Required string length: 22
Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$
created
string<date-time>
required

When this store row was first written.

modified
string<date-time>
required

When this store row last changed.

gln
string | null

GS1 Global Location Number identifying this store, when issued.

currency
string
default:""

ISO 4217 code offers at this store are priced in. Empty when unset.

address_line_1
string
default:""

Street address, number and street name.

address_line_2
string
default:""

Apartment, suite, unit or floor.

city
string
default:""

City, town or locality.

region
string
default:""

State, province or region.

postal_code
string
default:""

ZIP, postal code or postcode.

country
string
default:""

ISO 3166-1 alpha-2 country code of the store.

latitude
number | null

WGS84 latitude in decimal degrees. Null when uncoordinated.

longitude
number | null

WGS84 longitude in decimal degrees. Null when uncoordinated.