{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Retrieves the latest Internet outages and anomalies.","properties":{"query":{"type":"object","properties":{"limit":{"description":"Limits the number of objects returned in the response.","type":"integer","default":5,"exclusiveMinimum":0,"examples":[5]},"offset":{"description":"Skips the specified number of objects before fetching the results.","type":"integer","minimum":0,"examples":[0]},"dateRange":{"description":"Filters results by a relative date range ending at the current time. Use `<n>d` for days (up to `364d`) or `<n>w` for weeks (up to `52w`), e.g. `7d`. Append `control` to request the equivalent previous period for comparison: the comparison window is shifted back by the current window's length rounded up to a whole number of weeks, so it keeps the same weekday alignment and does not overlap the current window (e.g. `3dcontrol` covers days -10 to -7, `7dcontrol` covers days -14 to -7, `28dcontrol` covers days -56 to -28, and `10dcontrol` covers days -24 to -14). Mutually exclusive with `dateStart`/`dateEnd`.","type":"string","pattern":"^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$","examples":["7d"]},"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"]},"dataSource":{"description":"Filters results by data source.","type":"string","enum":["ALL","AI_BOTS","AI_GATEWAY","BGP","BOTS","CONNECTION_ANOMALY","CT","DNS","DNS_MAGNITUDE","DNS_AS112","DOS","EMAIL_ROUTING","EMAIL_SECURITY","FW","FW_PG","HTTP","HTTP_CONTROL","HTTP_CRAWLER_REFERER","HTTP_ORIGINS","IQI","LEAKED_CREDENTIALS","NET","ROBOTS_TXT","SPEED","WORKERS_AI"],"examples":["ALL"]},"outageType":{"description":"Filters results by outage type.","type":"string","enum":["NATIONWIDE","REGIONAL","NETWORK","PLATFORM"]},"outageCause":{"description":"Filters results by outage cause.","type":"string","enum":["BLOCKING","CABLE_CUT","CYBERATTACK","DNS","FIRE","GOVERNMENT_DIRECTED","MAINTENANCE","MECHANICAL","MILITARY_ACTION","MISCONFIGURATION","NATURAL_DISASTER","NETWORK_PROBLEM","POWER_OUTAGE","SOFTWARE","TECHNICAL_PROBLEM","UNKNOWN","WEATHER"]},"tags":{"description":"Filters results by annotation tag. Matches annotations carrying at least one of the given tags.","type":"array","items":{"description":"Dimension tag an annotation applies to.","enum":["ADM1","ADM2","API_TRAFFIC","ARC","AS","ASN","ATTACKS","AUTHOR","BANDWIDTH","BITRATE","BOT","BOT_CATEGORY","BOT_CLASS","BOT_KIND","BOT_OPERATOR","BROWSER","BROWSER_FAMILY","BYTES","CA","CACHE_HIT","CA_OWNER","CHECK_RESULT","CLIENT_TYPE","COMPROMISED","CONTENT_TYPE","CRAWL_PURPOSE","CRAWL_REFER_RATIO","DEVICE_TYPE","DKIM","DMARC","DNS","DNSSEC","DNSSEC_AWARE","DNSSEC_E2E","DOMAIN_CATEGORY","DURATION","EDNS","ENCRYPTED","ENTRY_TYPE","EXPIRATION_STATUS","HAS_IPS","HAS_MATCHING_ANSWER","HAS_WILDCARDS","HTTP_METHOD","HTTP_PROTOCOL","HTTP_VERSION","INDUSTRY","IP_VERSION","JITTER","KEY_AGREEMENT","LATENCY","LOCATION","LOCATION_LATENCY","LOG","LOG_API","LOG_OPERATOR","MALICIOUS","MANAGED_RULES","MITIGATION_PRODUCT","MODEL","NAMESERVER_LATENCY","ORIGIN","ORIGIN_AS","ORIGIN_LOCATION","ORIGIN_TARGET_LOCATION_PAIR","OS","PERCENTILE","POST_QUANTUM","PREFIX","PRODUCT","PROTOCOL","PROVIDER","PUBLIC_KEY_ALGORITHM","QUERY_TYPE","REFERER","REGION","RESPONSE_CODE","RESPONSE_STATUS","RESPONSE_STATUS_CATEGORY","RESPONSE_TTL","SIGNATURE_ALGORITHM","SPAM","SPF","SPOOF","SUCCESS_RATE","TARGET_LOCATION","TASK","THREAT_CATEGORY","TLD","TLD_DNS_MAGNITUDE","TLS_VERSION","UPDATE_TYPE","USER_AGENT","VALIDATION_LEVEL","VECTOR","VERTICAL"],"type":"string"}},"query":{"description":"Filters results by a free-text match on the annotation description, id, or linked entities (location, ASN, origin).","type":"string","maxLength":100,"examples":["portugal"]},"asn":{"description":"Filters results by Autonomous System. Specify a single Autonomous System Number (ASN) as integer.","type":"integer","examples":[174]},"location":{"description":"Filters results by location. Specify an alpha-2 location code.","type":"string","maxLength":2,"minLength":2,"examples":["US"]},"geoId":{"description":"Filters results by geolocation. Refer to [GeoNames](https://download.geonames.org/export/dump/readme.txt).","type":"string","maxLength":100,"examples":["3190509"]},"origin":{"description":"Filters results by origin.","type":"string","maxLength":100,"examples":["amazon-us-east-1"]},"tld":{"description":"Filters results by top-level domain.","type":"string","maxLength":63,"minLength":2,"pattern":"^[a-z0-9](?:[a-z0-9-]*[a-z0-9])$","examples":["com"]},"ca":{"description":"Filters results by certificate authority.","type":"string","maxLength":100},"log":{"description":"Filters results by certificate log.","type":"string","maxLength":100},"bot":{"description":"Filters results by bot.","type":"string","maxLength":100,"examples":["gptbot"]},"format":{"description":"Format in which results will be returned.","type":"string","enum":["JSON","CSV"],"examples":["json"]}},"required":[],"additionalProperties":false}},"required":[],"additionalProperties":false},"name":"Get latest Internet outages and anomalies","id":"cloudflare.radar-get-annotations-outages","example":{},"maxRequests":1,"summary":false}}