---
title: "Get all aggregated connections"
method: GET
path: "/api/v2/network/connections/aggregate"
tags: ["Cloud Network Monitoring"]
---

# Get all aggregated connections

`GET /api/v2/network/connections/aggregate`

Get all aggregated connections.

## Query parameters

- `from` integer
- `to` integer
- `group_by` string
- `tags` string
- `query` string
- `limit` integer

## Response `200`

OK

- SingleAggregatedConnectionResponseArray — List of aggregated connections.
  - `data` SingleAggregatedConnectionResponseData[] — Array of aggregated connection objects.
    - `attributes` SingleAggregatedConnectionResponseDataAttributes — Attributes for an aggregated connection.
      - `bytes_sent_by_client` integer — The total number of bytes sent by the client over the given period.
      - `bytes_sent_by_server` integer — The total number of bytes sent by the server over the given period.
      - `group_bys` object — The key, value pairs for each group by.
      - `packets_sent_by_client` integer — The total number of packets sent by the client over the given period.
      - `packets_sent_by_server` integer — The total number of packets sent by the server over the given period.
      - `rtt_micro_seconds` integer — Measured as TCP smoothed round trip time in microseconds (the time between a TCP frame being sent and acknowledged).
      - `tcp_closed_connections` integer — The number of TCP connections in a closed state. Measured in connections per second from the client.
      - `tcp_delivered_ce` integer — The number of TCP segments acknowledged with the ECN Congestion Experienced (CE) mark, indicating that an upstream router marked packets as experiencing congestion.
      - `tcp_established_connections` integer — The number of TCP connections in an established state. Measured in connections per second from the client.
      - `tcp_probe0_count` integer — The number of TCP zero-window probes sent. These probes are sent when the receiver advertises a zero receive window, indicating it cannot accept more data.
      - `tcp_rcv_ooo_pack` integer — The number of TCP packets received out of order. This indicates network-level packet reordering, which can degrade TCP performance by triggering spurious retransmissions and reducing throughput.
      - `tcp_recovery_count` integer — The number of TCP fast recovery events. Fast recovery retransmits lost segments detected through duplicate ACKs or selective acknowledgment (SACK) without waiting for a retransmission timeout.
      - `tcp_refusals` integer — The number of TCP connections that were refused by the server. Typically this indicates an attempt to connect to an IP/port that is not receiving connections, or a firewall/security misconfiguration.
      - `tcp_reord_seen` integer — The number of times reordering of sent packets was detected. Reordering detection adjusts the duplicate ACK threshold, preventing spurious retransmissions caused by out-of-order delivery.
      - `tcp_resets` integer — The number of TCP connections that were reset by the server.
      - `tcp_retransmits` integer — TCP Retransmits represent detected failures that are retransmitted to ensure delivery. Measured in count of retransmits from the client.
      - `tcp_rto_count` integer — The number of TCP retransmission timeouts (RTOs). An RTO occurs when an ACK is not received within the estimated round-trip time, forcing the sender to retransmit and halve its congestion window.
      - `tcp_timeouts` integer — The number of TCP connections that timed out from the perspective of the operating system. This can indicate general connectivity and latency issues.
    - `id` string — A unique identifier for the aggregated connection based on the group by values.
    - `type` 'aggregated_connection' — Aggregated connection resource type.

## Other responses

- `400` — Bad Request
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)