Skip to content
Console(opens in a new tab)

OperatingLocationSeasonalityIndex

The seasonality index shows whether a operating location has a recurring seasonal revenue pattern.

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

The seasonality index shows whether a operating location has a recurring seasonal revenue pattern. It measures how much the revenue concentrates in some months, and the month in which the revenue peaks each year.

The index answers two questions for each eligible operating location:

  1. Is the business seasonal? giniScore measures how much the revenue concentrates in some months.
  2. If the business is seasonal, when is the peak? recurringPeakMonth gives the calendar month with the highest concentration of revenue.

For example, a ski resort has a high giniScore, with a recurringPeakMonth of December. A tax preparation office peaks in early spring, with a recurringPeakMonth of April. The index shows the pattern, not its cause. Possible causes are the weather (an ice cream shop) and a regulatory deadline (a tax preparer). Other causes are the academic calendar (a school supply store), a holiday (a Christmas tree farm), and other factors.

The Gini score measures how much the card revenue concentrates in some months. It goes from 0, when the revenue is the same each month, to 1, when all the revenue is in one month. A score of 0.4 or more shows a meaningful seasonal concentration. Use 0.4 as the threshold for a seasonal business.

Score Meaning Examples
Less than 0.4 The revenue is almost the same all year. The business is not seasonal. A restaurant, a gas station
0.4 to 0.6 Moderate seasonality. There is a clear peak, but the revenue spreads across several months. An ice cream shop, a garden center
0.6 to 0.8 Strong seasonality. Most of the revenue is in a short period. A tax preparer, a farm
More than 0.8 Extreme concentration. Almost all the revenue is in 1 or 2 months. A Halloween costume store, a Christmas tree farm

Peak month: recurringPeakMonth and peakMonthRevenueShare

Section titled “Peak month: recurringPeakMonth and peakMonthRevenueShare”

recurringPeakMonth is the month in which the revenue concentrates most. The peak month must be the same in all observed periods, not in one year only.

The index comes from the card transaction revenue of a rolling 36-month observation window. A operating location is eligible only when its history and transaction volume are sufficient for a reliable result. A operating location is eligible if:

  • It has at least $10,000 in card revenue in each 12-month period of the observation window.
  • It has approximately 4 years or more of revenue history.

The index uses the revenue history of each business, not its industry or location. Not all tax preparers are seasonal, and not all ice cream shops are seasonal. An ice cream shop in Miami can have the same revenue all year, while one in Minnesota peaks sharply in summer.

Shortest path from a primary entity: Brand → operatingLocations → OperatingLocation → seasonalityIndexes → OperatingLocationSeasonalityIndex.

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
giniScore Gini Score Float A score from 0 to 1 measuring how concentrated a business’s card revenue is across months.
recurringPeakMonth Recurring Peak Month String The month (e.g. “July”) where card revenue is most concentrated across observed periods.
peakMonthRevenueShare Peak Month Revenue Share Float The revenue share of the peak calendar month, expressed as a value between 0 and 1.
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.

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

Response, as returned:

{
"data": {
"search": [
{
"id": "0f26fbef-3436-4f85-8bcd-31fe12a4f99a",
"operatingLocations": {
"edges": [
{
"node": {
"seasonalityIndexes": {
"edges": [
{
"node": {
"id": "00000076-0000-03c7-0000-0a8000000000",
"firstObservedDate": null,
"lastObservedDate": null,
"rank": 0,
"giniScore": 0.04
}
}
]
}
}
}
]
}
}
]
}
}