GET /radar/bgp/routes/upstreams/{asn}/timeseries

Retrieves the share of an AS’s observed paths carried by each direct upstream over time, derived from RouteViews RIB snapshots across all collectors (the combined product). Each upstream ASN is returned as its own series of shares (0–1); the least-significant upstreams beyond the requested limit are grouped into an "OTHER" series. Series share a common set of timestamps.

Servers

Path parameters

Name Type Required Description
asn Integer Yes

Single Autonomous System Number (ASN) as integer.

Query parameters

Name Type Required Description
limit Integer No

Number of upstream ASNs to return as separate series, ranked by the first bucket. Remaining upstreams are grouped into an "OTHER" series. Defaults to 5.

format String No

Format in which results will be returned.

Valid values:

  • "CSV"
  • "JSON"
ipVersion String No

Address family of the observed paths. Defaults to IPv4.

Valid values:

  • "IPv4"
  • "IPv6"

Default value: "IPv4"

dateEnd String No

End of the date range (inclusive). Alternative to dateRange; provide together with dateStart.

dateStart String No

Start of the date range (inclusive). Alternative to dateRange; provide together with dateEnd.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.