Skip to content
Console(opens in a new tab)

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.

This attribute does not include time series data and reflects the most current state of the brand’s locations.

This attribute is derived from:

  • Brand to operating location relationships
  • Operating location to address relationships
  • Address state and city information

Shortest path from a primary entity: Brand → locationDescriptions → BrandLocationDescription.

  • Brand.locationDescriptions
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.

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.

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"
}
}
]
}
}
]
}
}