--- title: Get TCP resets and timeouts summary --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Radar](https://developers.cloudflare.com/api/go/resources/radar) [TCP Resets Timeouts](https://developers.cloudflare.com/api/go/resources/radar/subresources/tcp_resets_timeouts) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get TCP resets and timeouts summary client.Radar.TCPResetsTimeouts.Summary(ctx, query) (\*[TCPResetsTimeoutSummaryResponse](), error) GET/radar/tcp\_resets\_timeouts/summary Retrieves the distribution of connection stage by TCP connections terminated within the first 10 packets by a reset or timeout. ##### 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) `User Details Write``User Details Read` ##### ParametersExpand Collapse
query TCPResetsTimeoutSummaryParams ASN param.Field\[\[]string]Optional Filters results by Autonomous System. Specify one or more Autonomous System Numbers (ASNs) as a comma-separated list. Prefix with - to exclude ASNs from results. For example, -174, 3356 excludes results from AS174, but includes results from AS3356. Link to this property Continent param.Field\[\[]string]Optional Filters results by continent. Specify a comma-separated list of alpha-2 codes. Prefix with - to exclude continents from results. For example, -EU,NA excludes results from EU, but includes results from NA. Link to this property DateEnd param.Field\[\[]Time]Optional End of the date range (inclusive). Alternative to dateRange; provide together with dateStart. When requesting comparison series, every series must resolve to the same duration as the main series. Each dateStart/dateEnd is floored to the nearest 15 minutes before evaluation, so windows whose durations match only before alignment may be rejected. Link to this property DateRange param.Field\[\[]string]Optional Filters results by relative date range ending at the current time, with each value producing a separate series. Use <n>d for days (up to 364d) or <n>w for weeks (up to 52w). Append control to request the equivalent previous period for comparison: the comparison window is shifted back by the current window’s length rounded up to a whole number of weeks, so it keeps the same weekday alignment and does not overlap the current window (e.g. 7dcontrol covers days -14 to -7, 10dcontrol covers days -24 to -14). For example, pass 7d and 7dcontrol to compare this week with the previous week. All series must resolve to the same duration as the main series; relative ranges (including control) satisfy this automatically. Use this parameter or set specific start and end dates (dateStart and dateEnd parameters). Link to this property DateStart param.Field\[\[]Time]Optional Start of the date range. Alternative to dateRange; provide together with dateEnd. When requesting comparison series, every series must resolve to the same duration as the main series. Each dateStart/dateEnd is floored to the nearest 15 minutes before evaluation, so windows whose durations match only before alignment may be rejected. Link to this property
Format param.Field\[TCPResetsTimeoutSummaryParamsFormat]Optional Format in which results will be returned. const TCPResetsTimeoutSummaryParamsFormatJson TCPResetsTimeoutSummaryParamsFormat = "JSON" Link to this property const TCPResetsTimeoutSummaryParamsFormatCsv TCPResetsTimeoutSummaryParamsFormat = "CSV" Link to this property
Link to this property Location param.Field\[\[]string]Optional Filters results by location. Specify a comma-separated list of alpha-2 codes. Prefix with - to exclude locations from results. For example, -US,PT excludes results from the US, but includes results from PT. Link to this property Name param.Field\[\[]string]Optional Array of names used to label the series in the response. Link to this property
[Link to this property](<#(resource)%20radar.tcp_resets_timeouts%20%3E%20(method)%20summary%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type TCPResetsTimeoutSummaryResponse struct{…}
Meta TCPResetsTimeoutSummaryResponseMeta Metadata for the results.
ConfidenceInfo TCPResetsTimeoutSummaryResponseMetaConfidenceInfo
Annotations \[]TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotation
DataSource TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource Data source for annotations. One of the following: const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceAll TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "ALL" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceAIBots TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "AI\_BOTS" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "AI\_GATEWAY" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceBGP TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "BGP" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceBots TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION\_ANOMALY" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceCT TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "CT" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceDNS TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "DNS" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "DNS\_MAGNITUDE" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "DNS\_AS112" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceDos TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "DOS" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL\_ROUTING" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL\_SECURITY" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceFw TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "FW" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceFwPg TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "FW\_PG" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceHTTP TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP\_CONTROL" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP\_CRAWLER\_REFERER" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP\_ORIGINS" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceIQI TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "IQI" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED\_CREDENTIALS" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceNet TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "NET" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS\_TXT" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceSpeed TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS\_AI" Link to this property
Link to this property Description string Link to this property EndDate Time formatdate-time Link to this property
EventType TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsEventType Event type for annotations. One of the following: const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsEventTypeGeneral TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsEventTypeOutage TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL\_PROJECTION" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsEventTypePipeline TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE" Link to this property const TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly TCPResetsTimeoutSummaryResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC\_ANOMALY" Link to this property
Link to this property IsInstantaneous bool Whether event is a single point in time or a time range. Link to this property LinkedURL string formaturi Link to this property StartDate Time formatdate-time Link to this property Tags \[]stringOptional Link to this property
Link to this property Level int64 Provides an indication of how much confidence Cloudflare has in the data. Link to this property
Link to this property
DateRange \[]TCPResetsTimeoutSummaryResponseMetaDateRange EndTime Time Adjusted end of date range. formatdate-time Link to this property StartTime Time Adjusted start of date range. formatdate-time Link to this property
Link to this property LastUpdated Time Timestamp of the last dataset update. formatdate-time Link to this property
Normalization TCPResetsTimeoutSummaryResponseMetaNormalization Normalization method applied to the results. Refer to Normalization methods. One of the following: const TCPResetsTimeoutSummaryResponseMetaNormalizationPercentage TCPResetsTimeoutSummaryResponseMetaNormalization = "PERCENTAGE" Link to this property const TCPResetsTimeoutSummaryResponseMetaNormalizationMin0Max TCPResetsTimeoutSummaryResponseMetaNormalization = "MIN0\_MAX" Link to this property const TCPResetsTimeoutSummaryResponseMetaNormalizationMinMax TCPResetsTimeoutSummaryResponseMetaNormalization = "MIN\_MAX" Link to this property const TCPResetsTimeoutSummaryResponseMetaNormalizationRawValues TCPResetsTimeoutSummaryResponseMetaNormalization = "RAW\_VALUES" Link to this property const TCPResetsTimeoutSummaryResponseMetaNormalizationPercentageChange TCPResetsTimeoutSummaryResponseMetaNormalization = "PERCENTAGE\_CHANGE" Link to this property const TCPResetsTimeoutSummaryResponseMetaNormalizationRollingAverage TCPResetsTimeoutSummaryResponseMetaNormalization = "ROLLING\_AVERAGE" Link to this property const TCPResetsTimeoutSummaryResponseMetaNormalizationOverlappedPercentage TCPResetsTimeoutSummaryResponseMetaNormalization = "OVERLAPPED\_PERCENTAGE" Link to this property const TCPResetsTimeoutSummaryResponseMetaNormalizationRatio TCPResetsTimeoutSummaryResponseMetaNormalization = "RATIO" Link to this property
Link to this property
Units \[]TCPResetsTimeoutSummaryResponseMetaUnit Measurement units for the results. Name string Link to this property Value string Link to this property
Link to this property
Link to this property
Summary0 TCPResetsTimeoutSummaryResponseSummary0 LaterInFlow string Connection resets within the first 10 packets from the client, but after the server has received multiple data packets. Link to this property NoMatch string All other connections. Link to this property PostAck string Connection resets or timeouts after the server received both a SYN packet and an ACK packet, meaning the connection was successfully established. Link to this property PostPsh string Connection resets or timeouts after the server received a packet with PSH flag set, following connection establishment. Link to this property PostSyn string Connection resets or timeouts after the server received only a single SYN packet. Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.tcp_resets_timeouts%20%3E%20(model)%20TCPResetsTimeoutSummaryResponse%20%3E%20(schema)>) ### Get TCP resets and timeouts summary Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/radar" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) response, err := client.Radar.TCPResetsTimeouts.Summary(context.TODO(), radar.TCPResetsTimeoutSummaryParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` 200 example ``` { "result": { "meta": { "confidenceInfo": { "annotations": [ { "dataSource": "ALL", "description": "Cable cut in Tonga", "endDate": "2019-12-27T18:11:19.117Z", "eventType": "GENERAL", "isInstantaneous": true, "linkedUrl": "https://example.com", "startDate": "2019-12-27T18:11:19.117Z", "tags": [ "BOT_CLASS" ] } ], "level": 0 }, "dateRange": [ { "endTime": "2022-09-17T10:22:57.555Z", "startTime": "2022-09-16T10:22:57.555Z" } ], "lastUpdated": "2019-12-27T18:11:19.117Z", "normalization": "PERCENTAGE", "units": [ { "name": "*", "value": "requests" } ] }, "summary_0": { "later_in_flow": "10", "no_match": "65", "post_ack": "5", "post_psh": "10", "post_syn": "10" } }, "success": true } ``` ##### Returns Examples 200 example ``` { "result": { "meta": { "confidenceInfo": { "annotations": [ { "dataSource": "ALL", "description": "Cable cut in Tonga", "endDate": "2019-12-27T18:11:19.117Z", "eventType": "GENERAL", "isInstantaneous": true, "linkedUrl": "https://example.com", "startDate": "2019-12-27T18:11:19.117Z", "tags": [ "BOT_CLASS" ] } ], "level": 0 }, "dateRange": [ { "endTime": "2022-09-17T10:22:57.555Z", "startTime": "2022-09-16T10:22:57.555Z" } ], "lastUpdated": "2019-12-27T18:11:19.117Z", "normalization": "PERCENTAGE", "units": [ { "name": "*", "value": "requests" } ] }, "summary_0": { "later_in_flow": "10", "no_match": "65", "post_ack": "5", "post_psh": "10", "post_syn": "10" } }, "success": true } ```