--- title: List detected connections --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Page Shield](https://developers.cloudflare.com/api/go/resources/page_shield) [Connections](https://developers.cloudflare.com/api/go/resources/page_shield/subresources/connections) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List detected connections client.PageShield.Connections.List(ctx, params) (\*SinglePage\[[ConnectionListResponse]()], error) GET/zones/{zone\_id}/page\_shield/connections Lists outbound connections made by webpages in the zone. ##### 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) `Page Shield``Domain Page Shield Read``Domain Page Shield``Page Shield Read``Zone Settings Write``Zone Settings Read` ##### ParametersExpand Collapse
params ConnectionListParams ZoneID param.Field\[string] Path param: Identifier maxLength32 Link to this property
Direction param.Field\[ConnectionListParamsDirection]Optional Query param: The direction used to sort returned connections. const ConnectionListParamsDirectionAsc ConnectionListParamsDirection = "asc" Link to this property const ConnectionListParamsDirectionDesc ConnectionListParamsDirection = "desc" Link to this property
Link to this property ExcludeCDNCGI param.Field\[bool]Optional Query param: When true, excludes connections seen in a /cdn-cgi path from the returned connections. The default value is true. Link to this property ExcludeURLs param.Field\[string]Optional Query param: Excludes connections whose URL contains one of the URL-encoded URLs separated by commas. Link to this property
Export param.Field\[ConnectionListParamsExport]Optional Query param: Export the list of connections as a file, limited to 50000 entries. const ConnectionListParamsExportCsv ConnectionListParamsExport = "csv" Link to this property
Link to this property Hosts param.Field\[string]Optional Query param: Includes connections that match one or more URL-encoded hostnames separated by commas. Wildcards are supported at the start and end of each hostname to support starts with, ends with and contains. If no wildcards are used, results will be filtered by exact match Link to this property
OrderBy param.Field\[ConnectionListParamsOrderBy]Optional Query param: The field used to sort returned connections. const ConnectionListParamsOrderByFirstSeenAt ConnectionListParamsOrderBy = "first\_seen\_at" Link to this property const ConnectionListParamsOrderByLastSeenAt ConnectionListParamsOrderBy = "last\_seen\_at" Link to this property
Link to this property Page param.Field\[string]Optional Query param: The current page number of the paginated results. We additionally support a special value “all”. When “all” is used, the API will return all the connections with the applied filters in a single page. This feature is best-effort and it may only work for zones with a low number of connections Link to this property PageURL param.Field\[string]Optional Query param: Includes connections that match one or more page URLs (separated by commas) where they were last seen Wildcards are supported at the start and end of each page URL to support starts with, ends with and contains. If no wildcards are used, results will be filtered by exact match Link to this property PerPage param.Field\[float64]Optional Query param: The number of results per page. maximum100 minimum1 Link to this property PrioritizeMalicious param.Field\[bool]Optional Query param: When true, malicious connections appear first in the returned connections. Link to this property Status param.Field\[string]Optional Query param: Filters the returned connections using a comma-separated list of connection statuses. Accepted values: active, infrequent, and inactive. The default value is active. Link to this property URLs param.Field\[string]Optional Query param: Includes connections whose URL contain one or more URL-encoded URLs separated by commas. Link to this property
[Link to this property](<#(resource)%20page_shield.connections%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type ConnectionListResponse struct{…} ID string Identifier maxLength32 Link to this property AddedAt Time formatdate-time Link to this property FirstSeenAt Time formatdate-time Link to this property Host string Link to this property LastSeenAt Time formatdate-time Link to this property URL string Link to this property URLContainsCDNCGIPath bool Link to this property DomainReportedMalicious boolOptional Link to this property FirstPageURL stringOptional Link to this property MaliciousDomainCategories \[]stringOptional Link to this property MaliciousURLCategories \[]stringOptional Link to this property PageURLs \[]stringOptional Link to this property URLReportedMalicious boolOptional Link to this property
[Link to this property](<#(resource)%20page_shield.connections%20%3E%20(model)%20ConnectionListResponse%20%3E%20(schema)>) ### List detected connections Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/page_shield" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) page, err := client.PageShield.Connections.List(context.TODO(), page_shield.ConnectionListParams{ ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` 200 example ``` { "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 }, "success": true, "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": [ { "id": "023e105f4ecef8ad9ca31a8372d0c353", "added_at": "2021-08-18T10:51:10.09615Z", "first_seen_at": "2021-08-18T10:51:08Z", "host": "blog.cloudflare.com", "last_seen_at": "2021-09-02T09:57:54Z", "url": "https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.6.0/js/bootstrap.min.js", "url_contains_cdn_cgi_path": false, "domain_reported_malicious": false, "first_page_url": "blog.cloudflare.com/page", "malicious_domain_categories": [ "Malware" ], "malicious_url_categories": [ "Malware" ], "page_urls": [ "blog.cloudflare.com/page1", "blog.cloudflare.com/page2" ], "url_reported_malicious": false } ] } ``` ##### Returns Examples 200 example ``` { "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 }, "success": true, "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": [ { "id": "023e105f4ecef8ad9ca31a8372d0c353", "added_at": "2021-08-18T10:51:10.09615Z", "first_seen_at": "2021-08-18T10:51:08Z", "host": "blog.cloudflare.com", "last_seen_at": "2021-09-02T09:57:54Z", "url": "https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.6.0/js/bootstrap.min.js", "url_contains_cdn_cgi_path": false, "domain_reported_malicious": false, "first_page_url": "blog.cloudflare.com/page", "malicious_domain_categories": [ "Malware" ], "malicious_url_categories": [ "Malware" ], "page_urls": [ "blog.cloudflare.com/page1", "blog.cloudflare.com/page2" ], "url_reported_malicious": false } ] } ```