Conviva API Granularity

Granularity Use the ISO 8601 duration format to specify time interval granularity. Metrics V3 APIs support a subset of granularity options for real-time and historical metrics.

Updated 2026-08-03 granularity

Granularity

Use the ISO 8601 duration format to specify time interval granularity. Metrics V3 APIs support a subset of granularity options.

Real-Time Metrics

The maximum length of the query time range is 15 minutes, where the default granularity is PT1M.

   

ALL means that metric data is calculated using the entire query time range as a single interval.

   

PT10S, PT11S, PT12S, PT13S, PT14S, PT15S, PT16S, PT17S, PT18S, PT19S, PT20S, PT21S, PT22S, PT23S, PT24S, PT25S, PT26S, PT27S, PT28S, PT29S, PT30S, PT31S, PT32S, PT33S, PT34S, PT35S, PT36S, PT37S, PT38S, PT39S, PT40S, PT41S, PT42S, PT43S, PT44S, PT45S, PT46S, PT47S, PT48S, PT49S, PT50S, PT51S, PT52S, PT53S, PT54S, PT55S, PT56S, PT57S, PT58S, PT59S.

   

PT1M.

 

Historical Metrics

   

ALL means that metric data is calculated using the entire query time range as a single interval.

   

Minutely data has a retention policy of 31 days. When using a minutely granularity, the start date of the time range must be within the last 31 days.

PT1M, PT2M, PT3M, PT4M, PT5M, PT6M, PT10M, PT12M, PT15M, PT20M, PT30M.

For non-group-by requests with a minutely granularity, the maximum length of the query time range is 24 hours.

For group-by requests with a minutely granularity, due to the large response data size, the length of the query time range is restricted according to the following rules:

  • PT1M (maximum length of 1 hour)

  • PT2M (maximum length of 2 hours)

  • PT3M (maximum length of 3 hours)

  • PT4M (maximum length of 4 hours)

  • PT5M (maximum length of 5 hours)

  • PT6M (maximum length of 6 hours)

  • PT10M (maximum length of 10 hours)

  • PT12M (maximum length of 12 hours)

  • PT15M (maximum length of 12 hours)

  • PT20M (maximum length of 12 hours)

  • PT30M (maximum length of 24 hours)

   

PT1H, PT2H, PT3H, PT4H, PT5H, PT6H, PT7H, PT8H, PT9H, PT10H, PT11H, PT12H, PT13H, PT14H, PT15H, PT16H, PT17H, PT18H, PT19H, PT20H, PT21H, PT22H, PT23H.

   

P1D, P2D, P3D, P4D, P5D, P6D, P7D, P8D, P9D, P10D, P11D, P12D, P13D, P14D, P15D, P16D, P17D, P18D, P19D, P20D, P21D, P22D, P23D, P24D, P25D, P26D, P27D, P28D, P29D, P30D

   

P1W, P2W, P3W, P4W, P5W, P6W, P7W, P8W, P9W, P10W