{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Retrieves certificate volume over time.","properties":{"query":{"type":"object","properties":{"aggInterval":{"description":"Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). When omitted, the interval is auto-selected from the requested date range; finer intervals are only available for shorter ranges. If the requested interval is too granular for the date range, the request is rejected.","type":"string","enum":["15m","1h","1d","1w"],"examples":["1h"]},"name":{"description":"Array of names used to label the series in the response.","type":"array","items":{"type":"string","examples":["main_series"]}},"dateRange":{"description":"Filters results by relative date range ending at the current time, with each value producing a separate series. Use `<n>d` for days (up to `364d`) or `<n>w` for weeks (up to `52w`). 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. `7dcontrol` covers days -14 to -7, `10dcontrol` covers days -24 to -14). For example, pass `7d` and `7dcontrol` to compare this week with the previous week. All series must resolve to the same duration as the main series; relative ranges (including `control`) satisfy this automatically. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).","type":"array","items":{"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)?))$","type":"string","examples":["7d"]},"examples":["7d"]},"dateStart":{"description":"Start of the date range. Alternative to `dateRange`; provide together with `dateEnd`. When requesting comparison series, every series must resolve to the same duration as the main series. Each `dateStart`/`dateEnd` is floored to the nearest 15 minutes before evaluation, so windows whose durations match only before alignment may be rejected.","type":"array","items":{"format":"date-time","type":"string"},"examples":["2023-09-01T11:41:33.782Z"]},"dateEnd":{"description":"End of the date range (inclusive). Alternative to `dateRange`; provide together with `dateStart`. When requesting comparison series, every series must resolve to the same duration as the main series. Each `dateStart`/`dateEnd` is floored to the nearest 15 minutes before evaluation, so windows whose durations match only before alignment may be rejected.","type":"array","items":{"format":"date-time","type":"string"},"examples":["2023-09-01T11:41:33.782Z"]},"ca":{"description":"Filters results by certificate authority.","type":"array","items":{"type":"string"}},"caOwner":{"description":"Filters results by certificate authority owner.","type":"array","items":{"type":"string"}},"duration":{"description":"Filters results by certificate duration.","type":"array","items":{"enum":["LTE_3D","GT_3D_LTE_7D","GT_7D_LTE_10D","GT_10D_LTE_47D","GT_47D_LTE_100D","GT_100D_LTE_200D","GT_200D"],"type":"string"}},"entryType":{"description":"Filters results by entry type (certificate vs. pre-certificate). Incompatible with the `tld` filter/dimension.","type":"array","items":{"enum":["PRECERTIFICATE","CERTIFICATE"],"type":"string"}},"expirationStatus":{"description":"Filters results by expiration status (expired vs. valid).","type":"array","items":{"enum":["EXPIRED","VALID"],"type":"string"}},"hasIps":{"description":"Filters results based on whether the certificates are bound to specific IP addresses.","type":"array","items":{"type":"boolean"}},"hasWildcards":{"description":"Filters results based on whether the certificates contain wildcard domains.","type":"array","items":{"type":"boolean"}},"log":{"description":"Filters results by certificate log. Incompatible with the `tld` filter/dimension.","type":"array","items":{"maxLength":100,"type":"string"}},"logApi":{"description":"Filters results by certificate log API (RFC6962 vs. static). Incompatible with the `tld` filter/dimension.","type":"array","items":{"enum":["RFC6962","STATIC"],"type":"string"}},"logOperator":{"description":"Filters results by certificate log operator. Incompatible with the `tld` filter/dimension.","type":"array","items":{"maxLength":100,"type":"string"}},"publicKeyAlgorithm":{"description":"Filters results by public key algorithm.","type":"array","items":{"enum":["DSA","ECDSA","RSA"],"type":"string"}},"signatureAlgorithm":{"description":"Filters results by signature algorithm.","type":"array","items":{"enum":["DSA_SHA_1","DSA_SHA_256","ECDSA_SHA_1","ECDSA_SHA_256","ECDSA_SHA_384","ECDSA_SHA_512","PSS_SHA_256","PSS_SHA_384","PSS_SHA_512","RSA_MD2","RSA_MD5","RSA_SHA_1","RSA_SHA_256","RSA_SHA_384","RSA_SHA_512"],"type":"string"}},"tld":{"description":"Filters results by top-level domain. Incompatible with the `log`, `logApi`, `logOperator`, and `entryType` filters/dimensions.","type":"array","items":{"maxLength":63,"minLength":2,"pattern":"^[a-z0-9](?:[a-z0-9-]*[a-z0-9])$","type":"string","examples":["com"]},"examples":["com"]},"validationLevel":{"description":"Filters results by validation level.","type":"array","items":{"enum":["DOMAIN","ORGANIZATION","EXTENDED"],"type":"string"}},"uniqueEntries":{"description":"Specifies whether to filter out duplicate certificates and pre-certificates. Set to true for unique entries only.","type":"array","items":{"enum":["true","false"],"type":"string"}},"format":{"description":"Format in which results will be returned.","type":"string","enum":["JSON","CSV"],"examples":["json"]}},"required":[],"additionalProperties":false}},"required":[],"additionalProperties":false},"name":"Get certificates time series","id":"cloudflare.radar-get-ct-timeseries","example":{},"maxRequests":1,"summary":false}}