--- title: Get certificates time series --- [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 certificates time series client.Radar.CT.Timeseries(ctx, query) (\*[CTTimeseriesResponse](), error) GET/radar/ct/timeseries Retrieves certificate volume 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

query CTTimeseriesParams

AggInterval param.Field\[CTTimeseriesParamsAggInterval]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 CTTimeseriesParamsAggInterval15m CTTimeseriesParamsAggInterval = "15m" Link to this property const CTTimeseriesParamsAggInterval1h CTTimeseriesParamsAggInterval = "1h" Link to this property const CTTimeseriesParamsAggInterval1d CTTimeseriesParamsAggInterval = "1d" Link to this property const CTTimeseriesParamsAggInterval1w CTTimeseriesParamsAggInterval = "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\[\[]CTTimeseriesParamsDuration]Optional Filters results by certificate duration.

const CTTimeseriesParamsDurationLte3D CTTimeseriesParamsDuration = "LTE\_3D" Link to this property const CTTimeseriesParamsDurationGt3DLte7D CTTimeseriesParamsDuration = "GT\_3D\_LTE\_7D" Link to this property const CTTimeseriesParamsDurationGt7DLte10D CTTimeseriesParamsDuration = "GT\_7D\_LTE\_10D" Link to this property const CTTimeseriesParamsDurationGt10DLte47D CTTimeseriesParamsDuration = "GT\_10D\_LTE\_47D" Link to this property const CTTimeseriesParamsDurationGt47DLte100D CTTimeseriesParamsDuration = "GT\_47D\_LTE\_100D" Link to this property const CTTimeseriesParamsDurationGt100DLte200D CTTimeseriesParamsDuration = "GT\_100D\_LTE\_200D" Link to this property const CTTimeseriesParamsDurationGt200D CTTimeseriesParamsDuration = "GT\_200D" Link to this property

Link to this property

EntryType param.Field\[\[]CTTimeseriesParamsEntryType]Optional Filters results by entry type (certificate vs. pre-certificate). Incompatible with the tld filter/dimension.

const CTTimeseriesParamsEntryTypePrecertificate CTTimeseriesParamsEntryType = "PRECERTIFICATE" Link to this property const CTTimeseriesParamsEntryTypeCertificate CTTimeseriesParamsEntryType = "CERTIFICATE" Link to this property

Link to this property

ExpirationStatus param.Field\[\[]CTTimeseriesParamsExpirationStatus]Optional Filters results by expiration status (expired vs. valid).

const CTTimeseriesParamsExpirationStatusExpired CTTimeseriesParamsExpirationStatus = "EXPIRED" Link to this property const CTTimeseriesParamsExpirationStatusValid CTTimeseriesParamsExpirationStatus = "VALID" Link to this property

Link to this property

Format param.Field\[CTTimeseriesParamsFormat]Optional Format in which results will be returned.

const CTTimeseriesParamsFormatJson CTTimeseriesParamsFormat = "JSON" Link to this property const CTTimeseriesParamsFormatCsv CTTimeseriesParamsFormat = "CSV" Link to this property

Link to this property HasIPs param.Field\[\[]bool]Optional Filters results based on whether the certificates are bound to specific IP addresses. Link to this property HasWildcards param.Field\[\[]bool]Optional Filters results based on whether the certificates contain wildcard domains. Link to this property Log param.Field\[\[]string]Optional Filters results by certificate log. Incompatible with the tld filter/dimension. Link to this property

LogAPI param.Field\[\[]CTTimeseriesParamsLogAPI]Optional Filters results by certificate log API (RFC6962 vs. static). Incompatible with the tld filter/dimension.

const CTTimeseriesParamsLogAPIRfc6962 CTTimeseriesParamsLogAPI = "RFC6962" Link to this property const CTTimeseriesParamsLogAPIStatic CTTimeseriesParamsLogAPI = "STATIC" Link to this property

Link to this property LogOperator param.Field\[\[]string]Optional Filters results by certificate log operator. Incompatible with the tld filter/dimension. Link to this property Name param.Field\[\[]string]Optional Array of names used to label the series in the response. Link to this property

PublicKeyAlgorithm param.Field\[\[]CTTimeseriesParamsPublicKeyAlgorithm]Optional Filters results by public key algorithm.

const CTTimeseriesParamsPublicKeyAlgorithmDsa CTTimeseriesParamsPublicKeyAlgorithm = "DSA" Link to this property const CTTimeseriesParamsPublicKeyAlgorithmEcdsa CTTimeseriesParamsPublicKeyAlgorithm = "ECDSA" Link to this property const CTTimeseriesParamsPublicKeyAlgorithmRSA CTTimeseriesParamsPublicKeyAlgorithm = "RSA" Link to this property

Link to this property

SignatureAlgorithm param.Field\[\[]CTTimeseriesParamsSignatureAlgorithm]Optional Filters results by signature algorithm.

const CTTimeseriesParamsSignatureAlgorithmDsaSha1 CTTimeseriesParamsSignatureAlgorithm = "DSA\_SHA\_1" Link to this property const CTTimeseriesParamsSignatureAlgorithmDsaSha256 CTTimeseriesParamsSignatureAlgorithm = "DSA\_SHA\_256" Link to this property const CTTimeseriesParamsSignatureAlgorithmEcdsaSha1 CTTimeseriesParamsSignatureAlgorithm = "ECDSA\_SHA\_1" Link to this property const CTTimeseriesParamsSignatureAlgorithmEcdsaSha256 CTTimeseriesParamsSignatureAlgorithm = "ECDSA\_SHA\_256" Link to this property const CTTimeseriesParamsSignatureAlgorithmEcdsaSha384 CTTimeseriesParamsSignatureAlgorithm = "ECDSA\_SHA\_384" Link to this property const CTTimeseriesParamsSignatureAlgorithmEcdsaSha512 CTTimeseriesParamsSignatureAlgorithm = "ECDSA\_SHA\_512" Link to this property const CTTimeseriesParamsSignatureAlgorithmPssSha256 CTTimeseriesParamsSignatureAlgorithm = "PSS\_SHA\_256" Link to this property const CTTimeseriesParamsSignatureAlgorithmPssSha384 CTTimeseriesParamsSignatureAlgorithm = "PSS\_SHA\_384" Link to this property const CTTimeseriesParamsSignatureAlgorithmPssSha512 CTTimeseriesParamsSignatureAlgorithm = "PSS\_SHA\_512" Link to this property const CTTimeseriesParamsSignatureAlgorithmRSAMd2 CTTimeseriesParamsSignatureAlgorithm = "RSA\_MD2" Link to this property const CTTimeseriesParamsSignatureAlgorithmRSAMd5 CTTimeseriesParamsSignatureAlgorithm = "RSA\_MD5" Link to this property const CTTimeseriesParamsSignatureAlgorithmRSASha1 CTTimeseriesParamsSignatureAlgorithm = "RSA\_SHA\_1" Link to this property const CTTimeseriesParamsSignatureAlgorithmRSASha256 CTTimeseriesParamsSignatureAlgorithm = "RSA\_SHA\_256" Link to this property const CTTimeseriesParamsSignatureAlgorithmRSASha384 CTTimeseriesParamsSignatureAlgorithm = "RSA\_SHA\_384" Link to this property const CTTimeseriesParamsSignatureAlgorithmRSASha512 CTTimeseriesParamsSignatureAlgorithm = "RSA\_SHA\_512" Link to this property

Link to this property TLD param.Field\[\[]string]Optional Filters results by top-level domain. Incompatible with the log, logApi, logOperator, and entryType filters/dimensions. Link to this property

UniqueEntries param.Field\[\[]CTTimeseriesParamsUniqueEntry]Optional Specifies whether to filter out duplicate certificates and pre-certificates. Set to true for unique entries only.

const CTTimeseriesParamsUniqueEntryTrue CTTimeseriesParamsUniqueEntry = "true" Link to this property const CTTimeseriesParamsUniqueEntryFalse CTTimeseriesParamsUniqueEntry = "false" Link to this property

Link to this property

ValidationLevel param.Field\[\[]CTTimeseriesParamsValidationLevel]Optional Filters results by validation level.

const CTTimeseriesParamsValidationLevelDomain CTTimeseriesParamsValidationLevel = "DOMAIN" Link to this property const CTTimeseriesParamsValidationLevelOrganization CTTimeseriesParamsValidationLevel = "ORGANIZATION" Link to this property const CTTimeseriesParamsValidationLevelExtended CTTimeseriesParamsValidationLevel = "EXTENDED" Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.ct%20%3E%20(method)%20timeseries%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse

type CTTimeseriesResponse struct{…}

Meta CTTimeseriesResponseMeta Metadata for the results.

AggInterval CTTimeseriesResponseMetaAggInterval Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: const CTTimeseriesResponseMetaAggIntervalFifteenMinutes CTTimeseriesResponseMetaAggInterval = "FIFTEEN\_MINUTES" Link to this property const CTTimeseriesResponseMetaAggIntervalOneHour CTTimeseriesResponseMetaAggInterval = "ONE\_HOUR" Link to this property const CTTimeseriesResponseMetaAggIntervalOneDay CTTimeseriesResponseMetaAggInterval = "ONE\_DAY" Link to this property const CTTimeseriesResponseMetaAggIntervalOneWeek CTTimeseriesResponseMetaAggInterval = "ONE\_WEEK" Link to this property const CTTimeseriesResponseMetaAggIntervalOneMonth CTTimeseriesResponseMetaAggInterval = "ONE\_MONTH" Link to this property

Link to this property

ConfidenceInfo CTTimeseriesResponseMetaConfidenceInfo

Annotations \[]CTTimeseriesResponseMetaConfidenceInfoAnnotation

DataSource CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource Data source for annotations.

One of the following: const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceAll CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "ALL" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceAIBots CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "AI\_BOTS" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "AI\_GATEWAY" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceBGP CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "BGP" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceBots CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION\_ANOMALY" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceCT CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "CT" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceDNS CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "DNS" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "DNS\_MAGNITUDE" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "DNS\_AS112" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceDos CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "DOS" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL\_ROUTING" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL\_SECURITY" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceFw CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "FW" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceFwPg CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "FW\_PG" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceHTTP CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP\_CONTROL" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP\_CRAWLER\_REFERER" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP\_ORIGINS" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceIQI CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "IQI" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED\_CREDENTIALS" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceNet CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "NET" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS\_TXT" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceSpeed CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI CTTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS\_AI" Link to this property

Link to this property Description string Link to this property EndDate Time formatdate-time Link to this property

EventType CTTimeseriesResponseMetaConfidenceInfoAnnotationsEventType Event type for annotations.

One of the following: const CTTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypeGeneral CTTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypeOutage CTTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection CTTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL\_PROJECTION" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypePipeline CTTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE" Link to this property const CTTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly CTTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC\_ANOMALY" Link to this property

Link to this property IsInstantaneous bool Whether event is a single point in time or a time range. Link to this property LinkedURL string formaturi Link to this property StartDate Time formatdate-time Link to this property Tags \[]stringOptional Link to this property

Link to this property Level int64 Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

DateRange \[]CTTimeseriesResponseMetaDateRange

EndTime Time Adjusted end of date range. formatdate-time Link to this property StartTime Time Adjusted start of date range. formatdate-time Link to this property

Link to this property LastUpdated Time Timestamp of the last dataset update. formatdate-time Link to this property

Normalization CTTimeseriesResponseMetaNormalization Normalization method applied to the results. Refer to Normalization methods.

One of the following: const CTTimeseriesResponseMetaNormalizationPercentage CTTimeseriesResponseMetaNormalization = "PERCENTAGE" Link to this property const CTTimeseriesResponseMetaNormalizationMin0Max CTTimeseriesResponseMetaNormalization = "MIN0\_MAX" Link to this property const CTTimeseriesResponseMetaNormalizationMinMax CTTimeseriesResponseMetaNormalization = "MIN\_MAX" Link to this property const CTTimeseriesResponseMetaNormalizationRawValues CTTimeseriesResponseMetaNormalization = "RAW\_VALUES" Link to this property const CTTimeseriesResponseMetaNormalizationPercentageChange CTTimeseriesResponseMetaNormalization = "PERCENTAGE\_CHANGE" Link to this property const CTTimeseriesResponseMetaNormalizationRollingAverage CTTimeseriesResponseMetaNormalization = "ROLLING\_AVERAGE" Link to this property const CTTimeseriesResponseMetaNormalizationOverlappedPercentage CTTimeseriesResponseMetaNormalization = "OVERLAPPED\_PERCENTAGE" Link to this property const CTTimeseriesResponseMetaNormalizationRatio CTTimeseriesResponseMetaNormalization = "RATIO" Link to this property

Link to this property

Units \[]CTTimeseriesResponseMetaUnit Measurement units for the results.

Name string Link to this property Value string Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.ct%20%3E%20(model)%20CTTimeseriesResponse%20%3E%20(schema)>) ### Get certificates time series Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/radar" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) response, err := client.Radar.CT.Timeseries(context.TODO(), radar.CTTimeseriesParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` 200 example ``` { "result": { "meta": { "aggInterval": "FIFTEEN_MINUTES", "confidenceInfo": { "annotations": [ { "dataSource": "ALL", "description": "Cable cut in Tonga", "endDate": "2019-12-27T18:11:19.117Z", "eventType": "GENERAL", "isInstantaneous": true, "linkedUrl": "https://example.com", "startDate": "2019-12-27T18:11:19.117Z", "tags": [ "BOT_CLASS" ] } ], "level": 0 }, "dateRange": [ { "endTime": "2022-09-17T10:22:57.555Z", "startTime": "2022-09-16T10:22:57.555Z" } ], "lastUpdated": "2019-12-27T18:11:19.117Z", "normalization": "PERCENTAGE", "units": [ { "name": "*", "value": "requests" } ] } }, "success": true } ``` ##### Returns Examples 200 example ``` { "result": { "meta": { "aggInterval": "FIFTEEN_MINUTES", "confidenceInfo": { "annotations": [ { "dataSource": "ALL", "description": "Cable cut in Tonga", "endDate": "2019-12-27T18:11:19.117Z", "eventType": "GENERAL", "isInstantaneous": true, "linkedUrl": "https://example.com", "startDate": "2019-12-27T18:11:19.117Z", "tags": [ "BOT_CLASS" ] } ], "level": 0 }, "dateRange": [ { "endTime": "2022-09-17T10:22:57.555Z", "startTime": "2022-09-16T10:22:57.555Z" } ], "lastUpdated": "2019-12-27T18:11:19.117Z", "normalization": "PERCENTAGE", "units": [ { "name": "*", "value": "requests" } ] } }, "success": true } ```