- Docs
- API reference
- Endpoints and schemas
- GraphQL
- Subject
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.
Fields
Section titled “Fields”| 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. |
Connections
Section titled “Connections”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. |
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.
Where it appears
Section titled “Where it appears”LegalEntity.operatingLocationsBrand.operatingLocationsWebsite.operatingLocationsAddress.operatingLocationsRole.operatingLocationsPhoneNumber.operatingLocationsRecord.operatingLocationsReviewSummary.operatingLocations
Example
Section titled “Example”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" } } ] } } ] }}