--- title: Get time series of certificate distribution by dimension --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Radar](https://developers.cloudflare.com/api/go/resources/radar) [CT](https://developers.cloudflare.com/api/go/resources/radar/subresources/ct) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get time series of certificate distribution by dimension client.Radar.CT.TimeseriesGroups(ctx, dimension, query) (\*[CTTimeseriesGroupsResponse](), error) GET/radar/ct/timeseries\_groups/{dimension} Retrieves the distribution of certificates grouped by the specified dimension over time. ##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

##### Accepted Permissions (at least one required) `User Details Write``User Details Read` ##### ParametersExpand Collapse

dimension CTTimeseriesGroupsParamsDimension Specifies the certificate attribute by which to group the results.

One of the following: const CTTimeseriesGroupsParamsDimensionCA CTTimeseriesGroupsParamsDimension = "CA" Link to this property const CTTimeseriesGroupsParamsDimensionCAOwner CTTimeseriesGroupsParamsDimension = "CA\_OWNER" Link to this property const CTTimeseriesGroupsParamsDimensionDuration CTTimeseriesGroupsParamsDimension = "DURATION" Link to this property const CTTimeseriesGroupsParamsDimensionEntryType CTTimeseriesGroupsParamsDimension = "ENTRY\_TYPE" Link to this property const CTTimeseriesGroupsParamsDimensionExpirationStatus CTTimeseriesGroupsParamsDimension = "EXPIRATION\_STATUS" Link to this property const CTTimeseriesGroupsParamsDimensionHasIPs CTTimeseriesGroupsParamsDimension = "HAS\_IPS" Link to this property const CTTimeseriesGroupsParamsDimensionHasWildcards CTTimeseriesGroupsParamsDimension = "HAS\_WILDCARDS" Link to this property const CTTimeseriesGroupsParamsDimensionLog CTTimeseriesGroupsParamsDimension = "LOG" Link to this property const CTTimeseriesGroupsParamsDimensionLogAPI CTTimeseriesGroupsParamsDimension = "LOG\_API" Link to this property const CTTimeseriesGroupsParamsDimensionLogOperator CTTimeseriesGroupsParamsDimension = "LOG\_OPERATOR" Link to this property const CTTimeseriesGroupsParamsDimensionPublicKeyAlgorithm CTTimeseriesGroupsParamsDimension = "PUBLIC\_KEY\_ALGORITHM" Link to this property const CTTimeseriesGroupsParamsDimensionSignatureAlgorithm CTTimeseriesGroupsParamsDimension = "SIGNATURE\_ALGORITHM" Link to this property const CTTimeseriesGroupsParamsDimensionTLD CTTimeseriesGroupsParamsDimension = "TLD" Link to this property const CTTimeseriesGroupsParamsDimensionValidationLevel CTTimeseriesGroupsParamsDimension = "VALIDATION\_LEVEL" Link to this property

[Link to this property](<#(resource)%20radar.ct%20%3E%20(method)%20timeseries_groups%20%3E%20(params)%20default%20%3E%20(param)%20dimension%20%3E%20(schema)>)

query CTTimeseriesGroupsParams

AggInterval param.Field\[CTTimeseriesGroupsParamsAggInterval]Optional Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to 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.

const CTTimeseriesGroupsParamsAggInterval15m CTTimeseriesGroupsParamsAggInterval = "15m" Link to this property const CTTimeseriesGroupsParamsAggInterval1h CTTimeseriesGroupsParamsAggInterval = "1h" Link to this property const CTTimeseriesGroupsParamsAggInterval1d CTTimeseriesGroupsParamsAggInterval = "1d" Link to this property const CTTimeseriesGroupsParamsAggInterval1w CTTimeseriesGroupsParamsAggInterval = "1w" Link to this property

Link to this property CA param.Field\[\[]string]Optional Filters results by certificate authority. Link to this property CAOwner param.Field\[\[]string]Optional Filters results by certificate authority owner. Link to this property DateEnd param.Field\[\[]Time]Optional 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. Link to this property DateRange param.Field\[\[]string]Optional 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). Link to this property DateStart param.Field\[\[]Time]Optional 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. Link to this property

Duration param.Field\[\[]CTTimeseriesGroupsParamsDuration]Optional Filters results by certificate duration.

const CTTimeseriesGroupsParamsDurationLte3D CTTimeseriesGroupsParamsDuration = "LTE\_3D" Link to this property const CTTimeseriesGroupsParamsDurationGt3DLte7D CTTimeseriesGroupsParamsDuration = "GT\_3D\_LTE\_7D" Link to this property const CTTimeseriesGroupsParamsDurationGt7DLte10D CTTimeseriesGroupsParamsDuration = "GT\_7D\_LTE\_10D" Link to this property const CTTimeseriesGroupsParamsDurationGt10DLte47D CTTimeseriesGroupsParamsDuration = "GT\_10D\_LTE\_47D" Link to this property const CTTimeseriesGroupsParamsDurationGt47DLte100D CTTimeseriesGroupsParamsDuration = "GT\_47D\_LTE\_100D" Link to this property const CTTimeseriesGroupsParamsDurationGt100DLte200D CTTimeseriesGroupsParamsDuration = "GT\_100D\_LTE\_200D" Link to this property const CTTimeseriesGroupsParamsDurationGt200D CTTimeseriesGroupsParamsDuration = "GT\_200D" Link to this property