Skip to content
Console(opens in a new tab)

OperatingLocation

An operating location is a place where a business does its work or serves customers, such as one store.

Subject. This entity is a subject: a kind of record that a search can start from. Name it in two places: entityType: OPERATING_LOCATION in the search input, and ... on OperatingLocation in the fields you read.

An operating location is a place where a business does its work or serves customers, such as one store. An operating location links the brands that operate there to the legal entities that own it.

Field Type Description
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.
enigmaId String An optional identifier that Enigma assigns to this object when custom identification is applicable.
id ID! The unique ID of the operating location.
tieBreakerMetadata OperatingLocationTieBreakerMetadata Values that order search results with equal match scores. The API does not fill these values today.
searchMetadata Searchmetadata Match details that show how this result matched each search input. The API does not fill these details today.

Each one is a connection: read it through edges { node { … } }, page it with first, and narrow it with conditions.

Field Leads to Description
names OperatingLocationName The name of the operating location. Default first: 3.
addresses Address A physical street address for the business. Default first: 100.
phoneNumbers PhoneNumber The phone number for a particular business entity. Default first: 100.
brands Brand The brands that operate at this operating location. Default first: 100.
roles Role These are roles which people (and other legal entities) hold at U.S. businesses. Default first: 100.
legalEntities LegalEntity The legal entities that own this operating location. Default first: 100.
operatingStatuses OperatingLocationOperatingStatus Indicates whether a location is Open, Temporarily Closed, Closed, or its status is Unknown. Default first: 3.
technologiesUseds OperatingLocationTechnologiesUsed Indicates third-party technologies being used at a particular operating location. Default first: 3.
records Record A structured entry from an upstream data source, such as a government filing or business registration, from which Enigma derives and links business entities. Default first: 10.
websites Website A website associated with a business. Default first: 100.
reviewSummaries ReviewSummary Summary of publicly available customer reviews for this entity. Default first: 100.
cardTransactions OperatingLocationCardTransaction Contains quantitative information about the card transactions processed by the operating location. Default first: 3.
revenueQualities OperatingLocationRevenueQuality Warnings and issues related to the revenue of this operating location. Default first: 3.
ranks OperatingLocationRank Indicates how the card revenue of this operating location compares to other operating locations of the same enigma industry within the geographical area. Default first: 3.
seasonalityIndexes OperatingLocationSeasonalityIndex The seasonality index shows whether a operating location has a recurring seasonal revenue pattern. Default first: 3.
isMarketables OperatingLocationIsMarketable Contains a boolean value indicating whether the operating location is marketable. Default first: 3.
locationTypes OperatingLocationLocationType The type of operating location (e.g. retail, office, etc.) Default first: 3.

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: OPERATING_LOCATION
name: "Safeway"
conditions: { limit: 1 }
}) {
... on OperatingLocation {
id
internalId
enigmaId
names(first: 1) { edges { node { name } } }
}
}
}

Response, as returned:

{
"data": {
"search": [
{
"id": "d45a0eb5-7125-4e6d-b21b-52b06d9ec639",
"internalId": null,
"enigmaId": null,
"names": {
"edges": [
{
"node": {
"name": "SAFEWAY LIQUOR"
}
}
]
}
}
]
}
}