---
title: "POST /v1/records:queryHistoryRecord"
method: POST
path: "/v1/records:queryHistoryRecord"
tags: ["records"]
---

# POST /v1/records:queryHistoryRecord

`POST /v1/records:queryHistoryRecord`

Queries the Chrome User Experience Report for a timeseries `history record` for a given site. Returns a `history record` that contains one or more `metric timeseries` corresponding to performance data about the requested site.

## Request body

- QueryHistoryRequest — Request payload sent by a physical web client. This request includes all necessary context to load a particular user experience history record.
  - `origin` string — The url pattern "origin" refers to a url pattern that is the origin of a website. Examples: "https://example.com", "https://cloud.google.com"
  - `metrics` string[] — The metrics that should be included in the response. If none are specified then any metrics found will be returned. Allowed values: ["first_contentful_paint", "first_input_delay", "largest_contentful_paint", "cumulative_layout_shift", "experimental_time_to_first_byte", "experimental_interaction_to_next_paint"]
  - `collectionPeriodCount` integer — The number of collection periods to return. If not specified, the default is 25. If present, must be in the range [1, 40].
  - `url` string — The url pattern "url" refers to a url pattern that is any arbitrary url. Examples: "https://example.com/", "https://cloud.google.com/why-google-cloud/"
  - `formFactor` 'ALL_FORM_FACTORS' | 'PHONE' | 'DESKTOP' | 'TABLET' — The form factor is a query dimension that specifies the device class that the record's data should belong to. Note: If no form factor is specified, then a special record with aggregated data over all form factors will be returned.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/chromeuxreport.md) · [All operations](https://skmtc.dev/google/apis/chromeuxreport/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/chromeuxreport/revisions/fed1ede2ade5/schema)