Skip to content
Console(opens in a new tab)

OperatingLocationOperatingStatus

Indicates whether a location is Open, Temporarily Closed, Closed, or its status is Unknown.

Selection. This type is a selection. You reach it through a connection, and you choose which of its fields come back.

Indicates whether a location is actively functioning (“Open”), out of operation (“Temporarily Closed”, “Closed”), or of uncertain status (“Unknown”).

We maintain the operating status as a time series. Each entry in the time series represents an unbroken period of time where we observed the same operating status. The rank property indicates the order of the time series and first_observed_date and last_observed_date indicate the beginning and end of the period.

  • Rank = 0: Reflects Enigma’s most recent, validated status observation.
  • Higher ranks (1, 2, etc.): Represent older, previously recorded statuses, preserved for reference and limited historical tracking.

This structure lets you understand

  • how the operating status has changed over time (e.g. temporary closures or seasonality)
  • a lower bound for how long the business has been operating
  • when a specific location has closed (this can be particularly helpful for evaluating openings and closings in businesses with multiple locations)

The operating status data is derived from:

  • Publicly available business data and listings (Enigma observes the operating status at least every three months, however, in many cases we are taking more frequent observations)
  • Privately verified business information
  • Open: Verified as open and functional through credible evidence or manual validation.
  • Temporarily Closed: Trusted data indicates the business has temporarily ceased operations, or the business is manually verified as temporarily closed.
  • Closed: Trusted data indicates the business has ceased operations, or the business is manually verified as closed.
  • Unknown: There is incomplete or insufficient information available to label the location as either Open or Closed.

Shortest path from a primary entity: Brand → operatingLocations → OperatingLocation → operatingStatuses → OperatingLocationOperatingStatus.

Field Label Type Description
operatingStatus Operating Status String Indicates whether a location is Open, Temporarily Closed, Closed, or its status is Unknown. See the values.
id ID UUID! The unique identifier of this object.
firstObservedDate First Observed Date String The earliest source date in one unbroken period of this operating status. Enigma starts a new period each time the status changes. When a location moves, Enigma adds a Closed status, and this value is the last date observed at the old location.
lastObservedDate Last Observed Date String The latest source date in one unbroken period of this operating status. For a Closed status that Enigma adds when a location moves, this value is the first date observed at the new location.
rank Rank Int Determines the display order of the attribute, with lower values shown first
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.
internalOperatingLocationId String The internalId of the operating location that this attribute describes.
Value Meaning
Open Verified open and functional based on the latest checks.
Temporarily Closed Verified as temporarily closed.
Closed Verified no longer operating.
Unknown Insufficient or unreliable data to determine a definitive status.

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
operatingLocations(first: 1) {
edges { node {
operatingStatuses(first: 1) {
edges { node {
id
operatingStatus
firstObservedDate
lastObservedDate
rank
} }
}
} }
}
}
}
}

Response, as returned:

{
"data": {
"search": [
{
"id": "0f26fbef-3436-4f85-8bcd-31fe12a4f99a",
"operatingLocations": {
"edges": [
{
"node": {
"operatingStatuses": {
"edges": [
{
"node": {
"id": "00000004-0004-f3af-0000-098000000000",
"operatingStatus": "Open",
"firstObservedDate": "2023-08-01 01:06:37+00",
"lastObservedDate": "2023-08-15 09:05:14+00",
"rank": 0
}
}
]
}
}
}
]
}
}
]
}
}