---
schema_version: "1"
id: 5a8ed2a6f44b2e3b06040c061ac7d541ade348e9e20914c33c4db6e30d66c8fd
title: Lightning Usage by Page
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/platform/api-rest/guides/resources/resources-lightning-usagebypagemetrics.md
canonical_url: https://developer.salesforce.com/docs/platform/api-rest/guide/resources-lightning-usagebypagemetrics.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 98e1f680f65aea56a84ca091b1ade68971cd20117b1c724a4612e463b364f446
products:
  - REST API Developer Guide
  - Platform Developer Content
---

# 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`.