get

api.monogoto.io/v1/netflow/top-destinations

Get Top Destinations

Scopes

netflow_dashboard:read

Rate limited

60 reqevery 1 minute·keyed byUser ID

Retrieve the top network destinations (remote IP addresses) by traffic volume. Traffic to and from known DNS servers is excluded here; it is reported by GET /v1/netflow/top-dns-transfer.

Each row carries the destination ip, its most common DNS name (dns_name, empty when unknown), its resolved location (empty when unknown), and the upload / download byte counts.

Parameters

Query

start_timedate-time

optional

Start time for the report in ISO 8601 UTC format. Either period, or both start_time and end_time, must be sent — otherwise 422. When both are sent, start_time/end_time take precedence over period.

end_timedate-time

optional

End time for the report in ISO 8601 UTC format. Required together with start_time. Must not be before start_time, and the range cannot exceed 180 days (422).

periodstring

optional

Predefined report period. Required unless both start_time and end_time are sent.

enum:todaylast_24_hoursyesterdaylast_7_daysthis_monthlast_monthlast_30_daysthis_quarterlast_quarterthis_yearlast_yearlast_12_months

iccidstring

optional

Filter by a specific ICCID.

profilestring

optional

Filter by Profile name (see GET /v1/filters/profiles).

See valid values

mnostring

optional

Filter by MNO name (see GET /v1/filters/mno).

See valid values

groupstring

optional

Filter by Group name (see GET /v1/filters/groups).

See valid values

countrystring

optional

Filter by Country (see GET /v1/filters/countries).

See valid values

protocolstring

optional

Filter by IP protocol number, e.g. 6 = TCP, 17 = UDP (see GET /v1/filters/protocols).

See valid values

breakoutstring

optional

Filter by Breakout (see GET /v1/filters/breakout).

See valid values

Responses

Top Destinations retrieved successfully

application/json

object

status_codeinteger

required

HTTP status code

messagestring

required

Response message

dataobject

required

applied_filtersobject

required

The filters that were applied to generate the report, echoed under the query-parameter names that were sent. Only filters that were sent are present.

fromstring · date-time

optional

Start timestamp of the report range (UTC).

tostring · date-time

optional

End timestamp of the report range (UTC).

countrystring

optional

Filtered country.

groupstring

optional

Filtered group name.

mnostring

optional

Filtered MNO.

profilestring

optional

Filtered profile name.

breakoutstring

optional

Filtered breakout.

protocolstring

optional

Filtered IP protocol number.

iccidstring

optional

Filtered ICCID.

reportarray[object]

required

[ ]object

optional

request_idstring

required

Unique request ID for tracking

Example

{
  "status_code": 200,
  "message": "Success",
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "applied_filters": {
      "from": "2026-01-25T00:00:00Z",
      "to": "2026-01-26T00:00:00Z"
    },
    "report": [
      {
        "ip": "142.250.74.110",
        "dns_name": "www.google.com",
        "location": "United States",
        "upload": 20480,
        "download": 1024000
      }
    ]
  }
}

GET

Get Enriched NetFlow Data

/v1/netflow/enriched

GET

Get Network Diagram Summary

/v1/netflow/networkdiagram-summary

GET

Get Data Transfer

/v1/netflow/data-transfer

GET

Get Services

/v1/netflow/services

GET

Get Protocols

/v1/netflow/protocols

Was this page helpful?

curl -X GET 'https://api.monogoto.io/v1/netflow/top-destinations?start_time=2026-01-25T00%3A00%3A00Z&end_time=2026-01-26T00%3A00%3A00Z&period=last_30_days&iccid=8988223000000000001&profile=Profile%20A&mno=VODAFONE%20ITALIA%20S.P.A&group=Test%20Warehouse&country=United%20States&protocol=6&breakout=Frankfurt' \ -H 'Authorization: Bearer $TOKEN'

{ "status_code": 200, "message": "Success", "request_id": "550e8400-e29b-41d4-a716-446655440000", "data": { "applied_filters": { "from": "2026-01-25T00:00:00Z", "to": "2026-01-26T00:00:00Z" }, "report": [ { "ip": "142.250.74.110", "dns_name": "www.google.com", "location": "United States", "upload": 20480, "download": 1024000 } ] } }

Parameters

Query

start_timedate-time

optional

end_timedate-time

optional

End time for the report in ISO 8601 UTC format. Required together with start_time. Must not be before start_time, and the range cannot exceed 180 days (422).

periodstring

optional

Predefined report period. Required unless both start_time and end_time are sent.

enum:todaylast_24_hoursyesterdaylast_7_daysthis_monthlast_monthlast_30_daysthis_quarterlast_quarterthis_yearlast_yearlast_12_months

iccidstring

optional

Filter by a specific ICCID.

profilestring

optional

Filter by Profile name (see GET /v1/filters/profiles).

See valid values

mnostring

optional

Filter by MNO name (see GET /v1/filters/mno).

See valid values

groupstring

optional

Filter by Group name (see GET /v1/filters/groups).

See valid values

countrystring

optional

Filter by Country (see GET /v1/filters/countries).

See valid values

protocolstring

optional

Filter by IP protocol number, e.g. 6 = TCP, 17 = UDP (see GET /v1/filters/protocols).

See valid values

breakoutstring

optional

Filter by Breakout (see GET /v1/filters/breakout).

See valid values

Responses

Top Destinations retrieved successfully

application/json

object

status_codeinteger

required

HTTP status code

messagestring

required

Response message

dataobject

required

applied_filtersobject

required

The filters that were applied to generate the report, echoed under the query-parameter names that were sent. Only filters that were sent are present.

fromstring · date-time

optional

Start timestamp of the report range (UTC).

tostring · date-time

optional

End timestamp of the report range (UTC).

countrystring

optional

Filtered country.

groupstring

optional

Filtered group name.

mnostring

optional

Filtered MNO.

profilestring

optional

Filtered profile name.

breakoutstring

optional

Filtered breakout.

protocolstring

optional

Filtered IP protocol number.

iccidstring

optional

Filtered ICCID.

reportarray[object]

required

[ ]object

optional

request_idstring

required

Unique request ID for tracking

Example

{
  "status_code": 200,
  "message": "Success",
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "applied_filters": {
      "from": "2026-01-25T00:00:00Z",
      "to": "2026-01-26T00:00:00Z"
    },
    "report": [
      {
        "ip": "142.250.74.110",
        "dns_name": "www.google.com",
        "location": "United States",
        "upload": 20480,
        "download": 1024000
      }
    ]
  }
}

Get Top Destinations

Parameters

Responses

Related

Get Top Destinations

Parameters

Responses

Related