- Docs
- API reference
- Endpoints and schemas
- GraphQL
- Selection
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”).
Time Series
Section titled “Time Series”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)
Data Sources
Section titled “Data Sources”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
Operating Status Values
Section titled “Operating Status Values”- 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.
Where it appears
Section titled “Where it appears”Shortest path from a primary entity: Brand → operatingLocations → OperatingLocation → operatingStatuses → OperatingLocationOperatingStatus.
OperatingLocation.operatingStatuses
Fields
Section titled “Fields”| 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. |
operatingStatus values
Section titled “operatingStatus values”| 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. |
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 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 } } ] } } } ] } } ] }}