--- title: List tested webpages --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Speed](https://developers.cloudflare.com/api/go/resources/speed) [Pages](https://developers.cloudflare.com/api/go/resources/speed/subresources/pages) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List tested webpages client.Speed.Pages.List(ctx, query) (\*SinglePage\[[PageListResponse]()], error) GET/zones/{zone\_id}/speed\_api/pages Lists all webpages which have been tested. ##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

##### Accepted Permissions (at least one required) `Zone Settings Write``Zone Settings Read` ##### ParametersExpand Collapse

query PageListParams

ZoneID param.Field\[string] Identifier. maxLength32 Link to this property

[Link to this property](<#(resource)%20speed.pages%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse

type PageListResponse struct{…}

Region LabeledRegionOptional A test region with a label.

Label stringOptional Link to this property

Value LabeledRegionValueOptional A test region.

One of the following: const LabeledRegionValueAsiaEast1 LabeledRegionValue = "asia-east1" Link to this property const LabeledRegionValueAsiaNortheast1 LabeledRegionValue = "asia-northeast1" Link to this property const LabeledRegionValueAsiaNortheast2 LabeledRegionValue = "asia-northeast2" Link to this property const LabeledRegionValueAsiaSouth1 LabeledRegionValue = "asia-south1" Link to this property const LabeledRegionValueAsiaSoutheast1 LabeledRegionValue = "asia-southeast1" Link to this property const LabeledRegionValueAustraliaSoutheast1 LabeledRegionValue = "australia-southeast1" Link to this property const LabeledRegionValueEuropeNorth1 LabeledRegionValue = "europe-north1" Link to this property const LabeledRegionValueEuropeSouthwest1 LabeledRegionValue = "europe-southwest1" Link to this property const LabeledRegionValueEuropeWest1 LabeledRegionValue = "europe-west1" Link to this property const LabeledRegionValueEuropeWest2 LabeledRegionValue = "europe-west2" Link to this property const LabeledRegionValueEuropeWest3 LabeledRegionValue = "europe-west3" Link to this property const LabeledRegionValueEuropeWest4 LabeledRegionValue = "europe-west4" Link to this property const LabeledRegionValueEuropeWest8 LabeledRegionValue = "europe-west8" Link to this property const LabeledRegionValueEuropeWest9 LabeledRegionValue = "europe-west9" Link to this property const LabeledRegionValueMeWest1 LabeledRegionValue = "me-west1" Link to this property const LabeledRegionValueSouthamericaEast1 LabeledRegionValue = "southamerica-east1" Link to this property const LabeledRegionValueUsCentral1 LabeledRegionValue = "us-central1" Link to this property const LabeledRegionValueUsEast1 LabeledRegionValue = "us-east1" Link to this property const LabeledRegionValueUsEast4 LabeledRegionValue = "us-east4" Link to this property const LabeledRegionValueUsSouth1 LabeledRegionValue = "us-south1" Link to this property const LabeledRegionValueUsWest1 LabeledRegionValue = "us-west1" Link to this property

Link to this property

ScheduleFrequency PageListResponseScheduleFrequencyOptional The frequency of the test.

One of the following: const PageListResponseScheduleFrequencyDaily PageListResponseScheduleFrequency = "DAILY" Link to this property const PageListResponseScheduleFrequencyWeekly PageListResponseScheduleFrequency = "WEEKLY" Link to this property

Link to this property

Tests \[]TestOptional

ID stringOptional UUID. maxLength36 Link to this property Date TimeOptional formatdate-time Link to this property

DesktopReport LighthouseReportOptional The Lighthouse report.

CLS float64Optional Cumulative Layout Shift. Link to this property

DeviceType LighthouseReportDeviceTypeOptional The type of device.

One of the following: const LighthouseReportDeviceTypeDesktop LighthouseReportDeviceType = "DESKTOP" Link to this property const LighthouseReportDeviceTypeMobile LighthouseReportDeviceType = "MOBILE" Link to this property

Link to this property

Error LighthouseReportErrorOptional

Code LighthouseReportErrorCodeOptional The error code of the Lighthouse result.

One of the following: const LighthouseReportErrorCodeNotReachable LighthouseReportErrorCode = "NOT\_REACHABLE" Link to this property const LighthouseReportErrorCodeDNSFailure LighthouseReportErrorCode = "DNS\_FAILURE" Link to this property const LighthouseReportErrorCodeNotHTML LighthouseReportErrorCode = "NOT\_HTML" Link to this property const LighthouseReportErrorCodeLighthouseTimeout LighthouseReportErrorCode = "LIGHTHOUSE\_TIMEOUT" Link to this property const LighthouseReportErrorCodeUnknown LighthouseReportErrorCode = "UNKNOWN" Link to this property

Link to this property Detail stringOptional Detailed error message. Link to this property FinalDisplayedURL stringOptional The final URL displayed to the user. Link to this property

Link to this property FCP float64Optional First Contentful Paint. Link to this property JsonReportURL stringOptional The URL to the full Lighthouse JSON report. Link to this property LCP float64Optional Largest Contentful Paint. Link to this property PerformanceScore float64Optional The Lighthouse performance score. Link to this property Si float64Optional Speed Index. Link to this property

State LighthouseReportStateOptional The state of the Lighthouse report.

One of the following: const LighthouseReportStateRunning LighthouseReportState = "RUNNING" Link to this property const LighthouseReportStateComplete LighthouseReportState = "COMPLETE" Link to this property const LighthouseReportStateFailed LighthouseReportState = "FAILED" Link to this property

Link to this property TBT float64Optional Total Blocking Time. Link to this property TTFB float64Optional Time To First Byte. Link to this property TTI float64Optional Time To Interactive. Link to this property

Link to this property

MobileReport LighthouseReportOptional The Lighthouse report.

CLS float64Optional Cumulative Layout Shift. Link to this property

DeviceType LighthouseReportDeviceTypeOptional The type of device.

Link to this property

Error LighthouseReportErrorOptional

Code LighthouseReportErrorCodeOptional The error code of the Lighthouse result.

Link to this property Detail stringOptional Detailed error message. Link to this property FinalDisplayedURL stringOptional The final URL displayed to the user. Link to this property

State LighthouseReportStateOptional The state of the Lighthouse report.

Link to this property

Region LabeledRegionOptional A test region with a label.

Label stringOptional Link to this property

Value LabeledRegionValueOptional A test region.

Link to this property

ScheduleFrequency TestScheduleFrequencyOptional The frequency of the test.

One of the following: const TestScheduleFrequencyDaily TestScheduleFrequency = "DAILY" Link to this property const TestScheduleFrequencyWeekly TestScheduleFrequency = "WEEKLY" Link to this property

Link to this property URL stringOptional A URL. Link to this property

[Link to this property](<#(resource)%20speed.pages%20%3E%20(model)%20PageListResponse%20%3E%20(schema)>) ### List tested webpages Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/speed" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) page, err := client.Speed.Pages.List(context.TODO(), speed.PageListParams{ ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": [ { "region": { "label": "Iowa, USA", "value": "us-central1" }, "scheduleFrequency": "DAILY", "tests": [ { "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415", "date": "2014-01-01T05:20:00.12345Z", "desktopReport": { "cls": 100, "deviceType": "DESKTOP", "error": { "code": "NOT_REACHABLE", "detail": "Details: net::ERR_CONNECTION_CLOSED", "finalDisplayedUrl": "example.com" }, "fcp": 100, "jsonReportUrl": "jsonReportUrl", "lcp": 100, "performanceScore": 90, "si": 100, "state": "COMPLETE", "tbt": 100, "ttfb": 100, "tti": 100 }, "mobileReport": { "cls": 100, "deviceType": "DESKTOP", "error": { "code": "NOT_REACHABLE", "detail": "Details: net::ERR_CONNECTION_CLOSED", "finalDisplayedUrl": "example.com" }, "fcp": 100, "jsonReportUrl": "jsonReportUrl", "lcp": 100, "performanceScore": 90, "si": 100, "state": "COMPLETE", "tbt": 100, "ttfb": 100, "tti": 100 }, "region": { "label": "Iowa, USA", "value": "us-central1" }, "scheduleFrequency": "DAILY", "url": "example.com" } ], "url": "example.com" } ] } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": [ { "region": { "label": "Iowa, USA", "value": "us-central1" }, "scheduleFrequency": "DAILY", "tests": [ { "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415", "date": "2014-01-01T05:20:00.12345Z", "desktopReport": { "cls": 100, "deviceType": "DESKTOP", "error": { "code": "NOT_REACHABLE", "detail": "Details: net::ERR_CONNECTION_CLOSED", "finalDisplayedUrl": "example.com" }, "fcp": 100, "jsonReportUrl": "jsonReportUrl", "lcp": 100, "performanceScore": 90, "si": 100, "state": "COMPLETE", "tbt": 100, "ttfb": 100, "tti": 100 }, "mobileReport": { "cls": 100, "deviceType": "DESKTOP", "error": { "code": "NOT_REACHABLE", "detail": "Details: net::ERR_CONNECTION_CLOSED", "finalDisplayedUrl": "example.com" }, "fcp": 100, "jsonReportUrl": "jsonReportUrl", "lcp": 100, "performanceScore": 90, "si": 100, "state": "COMPLETE", "tbt": 100, "ttfb": 100, "tti": 100 }, "region": { "label": "Iowa, USA", "value": "us-central1" }, "scheduleFrequency": "DAILY", "url": "example.com" } ], "url": "example.com" } ] } ```