get

api.monogoto.io/v1/netflow/dns-resolver-coverage

Get DNS Resolver Coverage

Scopes

netflow_dashboard:read

Rate limited

60 reqevery 1 minute·keyed byUser ID

Retrieve the share of the account's DNS traffic that Monogoto's own resolvers answered, measured on DNS query flows (measured_in: flows), including queries answered by third-party resolvers.

share is a fraction (0–1), or null when it cannot be measured (no own resolver is configured, or the account sent no DNS in the window). A client must render null as unknown, never as 0%. Device filters do not narrow this figure.

A user restricted to specific groups sees only those groups; one who holds no groups receives an empty report: [].

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

DNS Resolver Coverage 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.

reportobject

required

own_resolver_countinteger

optional

Number of own resolver addresses measured against.

measured_instring

optional

enum:"flows"

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": {
      "share": 0.82,
      "own_resolver_count": 2,
      "measured_in": "flows"
    }
  }
}

GET

Get Enriched NetFlow Data

/v1/netflow/enriched

GET

Get Network Diagram Summary

/v1/netflow/networkdiagram-summary

GET

Get Top Destinations

/v1/netflow/top-destinations

GET

Get Data Transfer

/v1/netflow/data-transfer

GET

Get Services

/v1/netflow/services

Was this page helpful?

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

DNS Resolver Coverage 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.

reportobject

required

own_resolver_countinteger

optional

Number of own resolver addresses measured against.

measured_instring

optional

enum:"flows"

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": {
      "share": 0.82,
      "own_resolver_count": 2,
      "measured_in": "flows"
    }
  }
}

Get DNS Resolver Coverage

Parameters

Responses

Related

Get DNS Resolver Coverage

Parameters

Responses

Related