{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"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.","properties":{"path":{"type":"object","properties":{"asn":{"description":"Single Autonomous System Number (ASN) as integer.","type":"integer","examples":[174]}},"required":["asn"],"additionalProperties":false},"query":{"type":"object","properties":{"ipVersion":{"description":"Address family of the observed paths. Defaults to IPv4.","type":"string","default":"IPv4","enum":["IPv4","IPv6"],"examples":["IPv4"]},"dateStart":{"description":"Start of the date range (inclusive). Alternative to `dateRange`; provide together with `dateEnd`.","type":"string","format":"date-time","examples":["2023-09-01T11:41:33.782Z"]},"dateEnd":{"description":"End of the date range (inclusive). Alternative to `dateRange`; provide together with `dateStart`.","type":"string","format":"date-time","examples":["2023-09-01T11:41:33.782Z"]},"limit":{"description":"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.","type":"integer","examples":[5]},"format":{"description":"Format in which results will be returned.","type":"string","enum":["JSON","CSV"],"examples":["json"]}},"required":[],"additionalProperties":false}},"required":["path"],"additionalProperties":false},"name":"Get upstream composition time series for an AS","id":"cloudflare.radar-get-bgp-routes-upstreams-timeseries","example":{"path":{"asn":174}},"maxRequests":1,"summary":false}}