Line entries
Entries through a named line inside a location (e.g. into a department, fitting rooms, or service area).
Returns entries across a within-location-entry line — a one-sided threshold counted whenever a person crosses into a defined zone inside the store. Use it to measure how many visitors entered a specific area (e.g. shoe department, cosmetics zone, fitting-room corridor).
Not the same as store-entry footfall. Counts of people entering the building are on Traffic > Entries. This page is for movement into zones inside a location.
Not the same as Location movement. A
within-location-entryline is a one-sided threshold (“did they step into this zone?”). Awithin-location-movementline is a two-sided gate (“did they cross between two zones?”) — see Location movement.
The line geometry — where the threshold sits and which side counts as “in” — is configured per recording. To enumerate the lines available for your locations, see Line definitions. The string you pass in taxonomy (e.g. "Products:Clothing:Shoes") refers to a configured line — see the Taxonomies concept page for how these are defined.
Body parameters
| Field | Type | Required | Description |
|---|---|---|---|
start | string (ISO 8601) | yes | Inclusive start timestamp with timezone |
end | string (ISO 8601) | yes | Inclusive end timestamp with timezone |
entities | string[] | yes | Array of location, organisation, or recording IDs (matching entityType) |
entityType | "location" | "organisation" | yes | Aggregation level |
taxonomy | string[] | yes | Array of zone path strings, e.g. ["Products:Clothing:Shoes"] — see how taxonomies work |
facets | string[] | yes | What to include: segments, summary, aggregates, thumbnails, thumbnails-with-statelems |
aggregationPeriod | string | yes | Time granularity — see aggregation period options |
breakdownByDimensions | string[] | no | Split data by: entity, taxonomy, age, gender, role |
roles | string[] | conditional | Required when breakdownByDimensions includes role. Values: customer, staff, customer-customer, customer-staff, staff-staff |
genders | string[] | conditional | Required when breakdownByDimensions includes gender. Values: male, female |
ages | string[] | conditional | Required when breakdownByDimensions includes age. Values: 0_15, 16_24, 25_34, 35_44, 45_54, 55_64, 65_100 |
insideRecordingTimes | boolean | no | true to restrict to opening hours only. Default false |
Example request
{
"action": "metric",
"data": {
"id": "req-le-001",
"route": "internal/line-entries",
"body": {
"start": "2024-04-01T00:00:00.000Z",
"end": "2024-04-07T23:59:59.000Z",
"entities": ["64a1b2c3d4e5f6a7b8c9d0e3"],
"entityType": "location",
"taxonomy": ["Products:Clothing:Shoes"],
"facets": ["segments", "summary"],
"aggregationPeriod": "day"
}
}
}Example response
req-le-001|0|0|{
"segments": [
{ "index": "2024-04-01T00:00:00.000", "location": "64a1b2c3d4e5f6a7b8c9d0e3", "internal_entries": 312 },
{ "index": "2024-04-02T00:00:00.000", "location": "64a1b2c3d4e5f6a7b8c9d0e3", "internal_entries": 287 }
],
"summary": [
{ "location": "64a1b2c3d4e5f6a7b8c9d0e3", "internal_entries": 1985 }
],
"meta": {
"units": {
"internal_entries": "peopleCount"
}
}
}Update frequency
Line events refresh throughout the day:
| Date range | Refresh cadence (UK time) |
|---|---|
| Today / recent days | Every ~10 minutes |
| Yesterday and historical | 02:00 daily |
| Last full week | 03:00 Mondays |
| Last full month / quarter / year | 05:00 on the 1st |