- Docs
- API reference
- Endpoints and schemas
- GraphQL
- Selection
BrandLocationDescription
A summary of where a brand operates geographically, showing either the top states for brands with multiple locations or the specific city and state for brands with a single location.
Selection. This type is a selection. You reach it through a connection, and you choose which of its fields come back.
A human-readable description of where a brand operates geographically, based on the states of its operating locations.
For brands with multiple locations, this shows the top states where the brand has a significant presence (either more than 10% of locations or more than 5 locations). Up to 5 states are listed alphabetically (e.g., “CA, FL, NY, TX, WA” or “CA, FL, NY, TX, WA and others” if there are more than 5 significant states).
For brands with a single location, this shows the specific city and state of that location (e.g., “San Francisco, CA”).
This attribute provides a quick summary of a brand’s geographic footprint without needing to examine all individual locations.
Time Structure
Section titled “Time Structure”This attribute does not include time series data and reflects the most current state of the brand’s locations.
Data Sources
Section titled “Data Sources”This attribute is derived from:
- Brand to operating location relationships
- Operating location to address relationships
- Address state and city information
Where it appears
Section titled “Where it appears”Shortest path from a primary entity: Brand → locationDescriptions → BrandLocationDescription.
Brand.locationDescriptions
Fields
Section titled “Fields”| Field | Label | Type | Description |
|---|---|---|---|
id |
ID | UUID! |
The unique identifier of this object. |
firstObservedDate |
First Observed Date | String |
The earliest date of a source record that supports this attribute or relationship. The source date is, for example, the date when Enigma collected the record or when the source last updated it. Most values have a date, a time, and a UTC offset, but some have the date only. |
lastObservedDate |
Last Observed Date | String |
The latest date of a source record that supports this attribute or relationship. It uses the same source dates and the same format as firstObservedDate. |
rank |
Rank | Int |
Determines the display order of the attribute, with lower values shown first |
locationDescription |
Location Description | String |
A text description of where a brand operates, showing either the top states for multi-location brands or the specific city and state for single-location brands. |
internalId |
String |
A numeric identifier that Enigma assigns to this object when it builds its data. On most attribute objects, id is the UUID form of this number. |
|
internalBrandId |
String |
The internalId of the brand that this attribute describes. |
Math fields
Section titled “Math fields”Every record of this type answers count, countDistinct, has, sum, min, max, avg, collect, minDateTime, maxDateTime. Each takes field and an optional conditions. See Selection.
Example
Section titled “Example”query { search(searchInput: { entityType: BRAND name: "Safeway" conditions: { limit: 1 } }) { ... on Brand { id locationDescriptions(first: 1) { edges { node { id firstObservedDate lastObservedDate rank locationDescription } } } } }}Response, as returned:
{ "data": { "search": [ { "id": "0f26fbef-3436-4f85-8bcd-31fe12a4f99a", "locationDescriptions": { "edges": [ { "node": { "id": "00000008-000d-dd72-0000-098000000000", "firstObservedDate": "2025-01-01", "lastObservedDate": "2025-01-01", "rank": 0, "locationDescription": "AZ, CA, CO, OR, WA" } } ] } } ] }}