--- updatedAt: 2026-03-01T18:27:22.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/reporting/llms.txt --- # delivery/ivm/image-traffic The following shows how to generate the `delivery/ivm/image-traffic` report with the [Generate a report](https://techdocs.akamai.com/reporting/reference/post-report-data) POST operation of the Reporting API v2. See also other [available reports](https://techdocs.akamai.com/reporting/reference/available-reports). # Report definition Provides traffic data for images configured to use Image and Video Manager. **Data available for**: 90 days **Required products**: Image and Video Manager ## Available metrics [block:parameters] { "data": { "h-0": "Metric name", "h-1": "Description", "h-2": "Configuration", "0-0": "`hits200`", "0-1": "The number of requests that returned successful responses.", "0-2": "`type: LONG,` \n`filterable: true,` \n`mandatory: false`", "1-0": "`bytes200`", "1-1": "The volume of data served with successful responses.", "1-2": "`type: LONG,` \n`filterable: true,` \n`mandatory: false`" }, "cols": 3, "rows": 2, "align": [ "left", "left", "left" ] } [/block] ## Available dimensions [block:parameters] { "data": { "h-0": "Dimension name", "h-1": "Description", "h-2": "Configuration", "0-0": "`cpcode`", "0-1": "Content provider (CP) code.", "0-2": "`type: LONG,` \n`filterable: true,` \n`mandatory: false,` `filterType: TEXT,` \n`authorizable: true`", "1-0": "`time5minutes`", "1-1": "Datapoint timestamp for 5 minutes granularity.", "1-2": "`type: LONG,` \n`filterable: true,` \n`mandatory: false,` `filterType: TEXT,` \n`authorizable: false`", "2-0": "`time1hour`", "2-1": "Datapoint timestamp for 1 hour granularity.", "2-2": "`type: LONG,` \n`filterable: true,` \n`mandatory: false,` `filterType: TEXT,` \n`authorizable: false`", "3-0": "`time1day`", "3-1": "Datapoint timestamp for 1 day granularity.", "3-2": "`type: LONG,` \n`filterable: true,` \n`mandatory: false,` \n `filterType: TEXT,` \n`authorizable: false`", "4-0": "`token`", "4-1": "The Image and Video Manager policy token for which you want data included.", "4-2": "`type: STRING,` \n`filterable: true,` \n`mandatory: false,` `filterType: TEXT,` \n`authorizable: false`", "5-0": "`tokenWithVersion`", "5-1": "The Image and Video Manager policy token with the version for which you want data included.", "5-2": "`type: STRING,` \n`filterable: true,` \n`mandatory: false,` `filterType: TEXT,` \n`authorizable: false`" }, "cols": 3, "rows": 6, "align": [ "left", "left", "left" ] } [/block] # Generate a report Use the [Generate a report](https://techdocs.akamai.com/reporting/reference/post-report-data) POST operation to execute a report. Follow the API workflows to: * [Gather necessary data to execute a report](https://techdocs.akamai.com/reporting/v2/reference/api-workflow#gather-data-to-execute-the-report). * [Form a request body](https://techdocs.akamai.com/reporting/v2/reference/api-workflow#form-a-request-body). * [Use filters](https://techdocs.akamai.com/reporting/reference/use-filters). * [Specify query parameters](https://techdocs.akamai.com/reporting/v2/reference/api-workflow#specify-query-parameters). * [Retrieve data asynchronously](https://techdocs.akamai.com/reporting/reference/retrieve-data-asynchronously). ## POST request sample **POST** `/reporting-api/v2/reports/delivery/ivm/image-traffic/data?timeRange=LAST_1_WEEK ` ## Available time ranges For this report, you can use the following predefined ranges in the `timeRange` query parameter. Use one of these time ranges or replace it with the `start` and `end` parameters in the ISO-8601 format. Read more about [setting the report time range](https://techdocs.akamai.com/reporting/reference/api-workflow#set-the-report-time-range). * `LAST_1_DAY` * `LAST_1_WEEK` * `LAST_30_DAYS` * `LAST_90_DAYS` > 📘 The start and end parameters in IVM reports > > IVM reports handle the `start` and `end` parameters differently from other reports. For IVM reports, data matching the end value's timestamp is included in the report. For example, when you set the time range `00:00:00-00:05:00` and the `time5min` dimension, the report includes both the `00:00:00` and `00:05:00` data points. The report shows data even if the time range doesn’t cover the whole five-minute period for the `time5min` dimension, one-hour period for the `time1hour` dimension, etc. For example, when you set the time range `00:00:00-00:04:00` and the `time5min` dimension, the report includes the `00:00:00` data point. ## Supported filters This report supports filtering by dimensions and metrics. You can filter by each dimension or metric that is labeled as `filterable: true` in the report options. See [how to use filters](https://techdocs.akamai.com/reporting/reference/use-filters). ## Request body example ```json { "dimensions": [ "cpcode", "time1day", "time1hour", "token" ], "metrics": [ "hits200", "bytes200" ], "filters": [ { "dimensionName": "cpcode", "operator": "IN_LIST", "expressions": [ "909500" ] }, ], "sortBys": [ { "name": "hits200", "sortOrder": "DESCENDING" } ], "limit": 1000 ``` ## Default values These default values apply to all requests, meaning they are used unless you specify otherwise. * **Time range**. Short relative range of 7 days: * **start**. `Now - 7 days` * **end**. `Now - 1 day` * **Metrics**: * `hits200` * `bytes200` * **Dimensions**: * `time1hour` * **Filters**: * `cpcode`. You can use all CP codes to which you are authorized in ​Control Center​. If you don't specify any CP codes in your request, the report shows data for all your available CP codes. * **SortBys**: * `hits200`, `DESCENDING` ## Limits Each report has some configured limits. If your request has values that exceed the limits, it results in a HTTP 400 Bad Request response. This report has the following limits: | Setting | Limit | | :---------------------------------------------------------------- | :------ | | Maximum number of dimensions | 4 | | Maximum time range | 90 days | | Maximum retention of historic data | 90 days | | Maximum number of values for filters using the `IN_LIST` operator | 10000 | | Maximum length of value for TEXT filters | 100 | | Maximum number of data points returned | 50000 | # Rate limiting This report uses the hit-based rate limiting. The limit is 200 requests per minute. In the asynchronous flow, you can have 3 queued POST requests at the same time. Read more about the [rate limiting](https://techdocs.akamai.com/reporting/reference/rate-limiting). # Get report options To get the report metadata through the API, run the [Get report options](https://techdocs.akamai.com/reporting/reference/get-report-options) operation. **GET** `/reporting-api/v2/reports/delivery/ivm/image-traffic` The response shows the list of available metrics and dimensions, the default values, and configured limits. ```json { "name": "IVM image traffic report data", "status": "PUBLISHED", "metrics": [ { "name": "hits200", "type": "LONG", "filterable": true, "mandatory": false }, { "name": "bytes200", "type": "LONG", "filterable": true, "mandatory": false } ], "dimensions": [ { "name": "cpcode", "type": "LONG", "filterable": true, "mandatory": false, "filterType": "TEXT", "authorizable": true }, { "name": "time5minutes", "type": "LONG", "filterable": true, "mandatory": false, "filterType": "TEXT", "authorizable": false }, { "name": "time1hour", "type": "LONG", "filterable": true, "mandatory": false, "filterType": "TEXT", "authorizable": false }, { "name": "time1day", "type": "LONG", "filterable": true, "mandatory": false, "filterType": "TEXT", "authorizable": false }, { "name": "token", "type": "STRING", "filterable": true, "mandatory": false, "filterType": "TEXT", "authorizable": false }, { "name": "tokenWithVersion", "type": "STRING", "filterable": true, "mandatory": false, "filterType": "TEXT", "authorizable": false } ], "predefinedTimeRanges": [ "LAST_1_DAY", "LAST_1_WEEK", "LAST_30_DAYS", "LAST_90_DAYS" ], "defaults": { "defaultTimeRange": { "start": "now - 7 days", "end": "now - 1 day" }, "defaultMetrics": [ "hits200", "bytes200" ], "defaultDimensions": [ "time1hour" ], "defaultSortBys": [ { "name": "hits200", "sortOrder": "DESCENDING" } ] }, "limits": { "maxDimensions": 4, "maxDateRangeInDays": 90, "maxRetentionInDays": 90, "inListFilterMaxValues": 10000, "textFilterMaxLength": 100, "dataPointsLimit": 50000 }, "links": [ { "rel": "self", "href": "/reporting-api/v2/reports/delivery/ivm/image-traffic", "describedBy": "/reporting-api/v2/reports/schema", "allow": [ "GET" ] }, { "rel": "data", "href": "/reporting-api/v2/reports/delivery/ivm/image-traffic/data", "allow": [ "POST" ] } ] } ``` # Sibling pages * [delivery/ivm/image-urls](https://techdocs.akamai.com/reporting/reference/delivery-ivm-image-urls.md) * [delivery/ivm/video-policy-stats](https://techdocs.akamai.com/reporting/reference/delivery-ivm-video-policy-stats.md) * [delivery/ivm/image-policy-stats](https://techdocs.akamai.com/reporting/reference/delivery-ivm-image-policy-stats.md) * [delivery/ivm/video-urls](https://techdocs.akamai.com/reporting/reference/delivery-ivm-video-urls.md) * [delivery/traffic/current](https://techdocs.akamai.com/reporting/reference/delivery-traffic-current.md) * [delivery/traffic/emissions](https://techdocs.akamai.com/reporting/reference/delivery-traffic-emissions.md) * [delivery/purge/usage](https://techdocs.akamai.com/reporting/reference/delivery-purge-usage.md) * [delivery/purge/audit-objects-details](https://techdocs.akamai.com/reporting/reference/delivery-purge-audit-objects-details.md) * [delivery/purge/audit-requests-details](https://techdocs.akamai.com/reporting/reference/delivery-purge-audit-requests-details.md) * [common/apis/usage](https://techdocs.akamai.com/reporting/reference/common-apis-usage.md) * [common/apis/usage-details](https://techdocs.akamai.com/reporting/reference/common-apis-usage-details.md)