# Lightning Usage by Page

Represents standard pages users viewed most frequently in Lightning Experience. This resource is available in REST API version 44.0 and later.

Use this object with the following APIs:

- Platform
- Metadata API
- Tooling API

## Syntax

**URI:** `/services/data/vXX.X/sobjects/LightningUsageByPageMetrics`

**Formats:** JSON, XML

**HTTP methods:** GET

## Example

```nolang
SELECT TotalCount FROM LightningUsageByPageMetrics ORDER BY PageName ASC NULLS FIRST LIMIT 10
```

## Considerations

:::note
The data in `LightningUsageByPageMetrics` is generated by a daily aggregation Spark job. Logs from the entire day, including raw EPT values, are processed and aggregated before being stored in the object. Due to this aggregation process, counts in `LightningUsageByPageMetrics` may not always match raw Event Monitoring logs.
:::

Raw EPT values (`orig_ept`) undergo validation and filtering before aggregation as `ept` values in `LightningUsageByPageMetrics`. Only valid EPT values are included in aggregated fields such as `ValidEptCount`, `medianEpt`, `sumEPT`, and EPT bucket counts.

A raw EPT value is considered valid if it falls within the following range:

```nolang
150 ms ≤ orig_ept ≤ 90,000 ms
```

If a raw EPT value is outside of this range, it's treated as invalid and gets aggregated as `ept = 0`.
