--- updatedAt: 2026-03-01T18:27:43.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/reporting/llms.txt --- # Get asynchronous report results Produces a report for an asynchronous request in either JSON or CSV format. # OpenAPI definition ```json { "externalDocs": { "description": "See documentation for Akamai's Reporting API", "url": "https://techdocs.akamai.com/reporting/reference" }, "info": { "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "title": "Reports", "version": "v2" }, "openapi": "3.0.0", "paths": { "/reports/{productFamily}/{reportingArea}/{report}/queries/{queryId}": { "get": { "description": "Produces a report for an asynchronous request in either JSON or CSV format.", "externalDocs": { "description": "See documentation for this operation in Akamai's Reporting API", "url": "https://techdocs.akamai.com/reporting/reference/get-report-data-async" }, "operationId": "get-report-data-async", "parameters": [ { "description": "For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys).", "in": "query", "name": "accountSwitchKey", "required": false, "schema": { "example": "1-5C0YLB:1-8BYUX", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": [ { "edgeBytesSum": 1322, "edgeHitsSum": 10, "hostname": "example.com", "responseCode": 404 }, { "edgeBytesSum": 321, "edgeHitsSum": 1, "hostname": "origin.com", "responseCode": 404 }, { "edgeBytesSum": 4331, "edgeHitsSum": 122, "hostname": "custom.com", "responseCode": 200 } ], "metadata": { "evictionTime": "2024-04-03T13:40:58Z", "links": [ { "allow": [ "GET" ], "href": "/reporting-api/v2/reports/delivery/traffic/current/queries/.kRGhlJDQv5gD34L8J+bfDLmmm6tIipFMHeve7o2udsr1mxoqQ6yHbaNjw43lIyzGX0Pko3ZcsSdFU4iEvETAogoL2ijtS3D385hhKIeQ9fOlgLixkCg9em001KtQIkI3JUCX5RxxkfK3iqBNai0988XYgPEUSpQt69D5gedOjrDMch4Vy.WRpOMQEXqURxrkXSOFVVIw0yDM62VJ8sRG3fsADRpYvpnsOeFz5Eko6lHH0TqzadAXFJEHQzS25Gu", "rel": "first" }, { "allow": [ "GET" ], "href": "/reporting-api/v2/reports/delivery/traffic/current/queries/.kRGhlJDQv5gD34L8J+bfDLmmm6tIipFMHeve7o2udsr1mxoqQ6yHbaNjw43lIyzGX0Pko3ZcsSdFU4iEvETAogoL2ijtS3D385hhKIeQ9fOlgLixkCg9em001KtQIkI3JUCX5RxxkfK3iqBNai0988XYgPEUSpQt69D5gedOjrDMch4Vy.WRpOMQEXqURxrkXSOFVVIw0yDM62VJ8sRG3fsADRpYvpnsOeFz5Eko6lHH0TqzadAXFJEHQzS25Gu", "rel": "self" }, { "allow": [ "GET" ], "href": "/reporting-api/v2/reports/delivery/traffic/current/queries/.kRGhlJDQv5gD34L8J+bfG++AQaipJ5zBKgT83AhMgEuUKZvnyG9nLz2eqMUAEVD7.lrvyrvOtUwIy9kCBd4Uw8sJKf+qhYKz3BxEZ8pNl9yqtfGreMCWmIOA3n5fKcxRP07cNb7iO5nC98cygroJk+2If7YG8MjWZ4jOMjPLsOUhIB4xeSjvkvTaNDGKhoXoO+K3BYFqSNrPxX37vbI7tFA6av4tWBoXwn4EGTa0GzenqGlx5m4FDcIxi2t2IOU", "rel": "next" }, { "allow": [ "GET" ], "href": "/reporting-api/v2/reports/delivery/traffic/current/queries/.kRGhlJDQv5gD34L8J+bfDLmmm6tIipFMHeve7o2udsr1mxoqQ6yHbaNjw43lIyzGX0Pko3ZcsSdFU4iEvETAogoL2ijtS3D385hhKIeQ9fOlgLixkCg9em001KtQIkI3JUCX5RxxkfK3iqBNai0988XYgPEUSpQt69D5gedOjrDMch4Vy.WRpOMQEXqURxrkXSOFVVIw0yDM62VJ8sRG3fsADRpYvpnsOeFz5Eko6lHH0TqzadAXFJEHQzS25Gu", "rel": "last" } ], "name": "CDN traffic report data", "requestTime": "2024-03-27T13:39:05.041Z", "rows": 3, "totalRows": 44 } }, "schema": { "additionalProperties": false, "description": "Encapsulates the report's data response for the asynchronous flow.", "properties": { "data": { "description": "Records returned for a given request.", "items": { "type": "object" }, "minItems": 0, "type": "array", "uniqueItems": true }, "metadata": { "additionalProperties": false, "description": "Contains information about the request and the response.", "properties": { "evictionTime": { "description": "The time when the cached data was removed.", "format": "date-time", "type": "string" }, "links": { "description": "Links for the requested path.", "items": { "additionalProperties": false, "properties": { "allow": { "description": "Allowed HTTP methods for the URL shown in `href`.", "items": { "minLength": 1, "type": "string" }, "minItems": 1, "type": "array", "uniqueItems": true }, "describedBy": { "description": "Relative URL address of the resource schema.", "minLength": 1, "type": "string" }, "href": { "description": "Relative URL address of the resource.", "minLength": 1, "type": "string" }, "rel": { "description": "Relative link name.", "minLength": 1, "type": "string" } }, "required": [ "rel", "href", "allow" ], "type": "object" }, "minItems": 1, "type": "array" }, "name": { "description": "Report name.", "minLength": 1, "type": "string" }, "requestTime": { "description": "The time when the query executed.", "format": "date-time", "type": "string" }, "rows": { "description": "The number of records for the current page.", "minimum": 0, "type": "integer" }, "totalRows": { "description": "The total number of records returned for the query.", "minimum": 0, "type": "integer" } }, "required": [ "name", "links", "rows", "totalRows" ], "type": "object" } }, "required": [ "data", "metadata" ], "type": "object" } }, "text/csv": { "example": "#METADATA_START\nstart,2024-03-27T13:09:48.218780097Z\nend,2024-03-27T13:19:47.218780097Z\nrowCount,5\ntotalRowCount,198\n#METADATA_END\n\n#LINKS_START\nfirst,/reporting-api/v2/reports/delivery/traffic/current/queries/.kRGhlJDQv5gD34L8J+bfDLmmm6tIipFMHeve7o2udsr1mxoqQ6yHbaNjw43lIyzGX0Pko3ZcsSdFU4iEvETAogoL2ijtS3D385hhKIeQ9fOlgLixkCg9em001KtQIkI3JUCX5RxxkfK3iqBNai0988XYgPEUSpQt69D5gedOjrDMch4Vy.WRpOMQEXqURxrkXSOFVVIw0yDM62VJ8sRG3fsADRpYvpnsOeFz5Eko6lHH0TqzadAXFJEHQzS25Gu\nself,/reporting-api/v2/reports/delivery/traffic/current/queries/.kRGhlJDQv5gD34L8J+bfDLmmm6tIipFMHeve7o2udsr1mxoqQ6yHbaNjw43lIyzGX0Pko3ZcsSdFU4iEvETAogoL2ijtS3D385hhKIeQ9fOlgLixkCg9em001KtQIkI3JUCX5RxxkfK3iqBNai0988XYgPEUSpQt69D5gedOjrDMch4Vy.WRpOMQEXqURxrkXSOFVVIw0yDM62VJ8sRG3fsADRpYvpnsOeFz5Eko6lHH0TqzadAXFJEHQzS25Gu\nnext,/reporting-api/v2/reports/delivery/traffic/current/queries/.kRGhlJDQv5gD34L8J+bfG++AQaipJ5zBKgT83AhMgEuUKZvnyG9nLz2eqMUAEVD7.lrvyrvOtUwIy9kCBd4Uw8sJKf+qhYKz3BxEZ8pNl9yqtfGreMCWmIOA3n5fKcxRP07cNb7iO5nC98cygroJk+2If7YG8MjWZ4jOMjPLsOUhIB4xeSjvkvTaNDGKhoXoO+K3BYFqSNrPxX37vbI7tFA6av4tWBoXwn4EGTa0GzenqGlx5m4FDcIxi2t2IOU\nlast,/reporting-api/v2/reports/delivery/traffic/current/queries/.kRGhlJDQv5gD34L8J+bfDLmmm6tIipFMHeve7o2udsr1mxoqQ6yHbaNjw43lIyzGX0Pko3ZcsSdFU4iEvETAogoL2ijtS3D385hhKIeQ9fOlgLixkCg9em001KtQIkI3JUCX5RxxkfK3iqBNai0988XYgPEUSpQt69D5gedOjrDMch4Vy.WRpOMQEXqURxrkXSOFVVIw0yDM62VJ8sRG3fsADRpYvpnsOeFz5Eko6lHH0TqzadAXFJEHQzS25Gu\n#LINKS_END\n\n#COLUMN_START\nhostname,responseCode,edgeHitsSum,edgeBytesSum\n#COLUMN_END\n\n#DATA_START\nexample.com,404,10,1322\norigin.com,404,1,321\ncustom.com,200,122,4331\n#DATA_END", "schema": { "type": "string" } } }, "description": "The request is processed. The response body contains the requested data." }, "303": { "content": {}, "description": "Results are delayed. The `Location` header provides a redirect link to get the results, which you can call after the number of seconds in the `Retry-After` header.", "headers": { "Location": { "description": "Specifies the relative URL that you can use in a GET data request.", "schema": { "example": "/reporting-api/v2/reports/delivery/traffic/current/queries/.kRGhlJDQv5gD34F8J+bfK.buOpx8.W6zxjHs30d8W9zqYTM0TvF7qegG9QfCC0ltsF4QwdnCRzfaWlirMK1sdge7gIYCsgvv5ldrtlu.9kq8VL35mrBbXEltisr6xnuumhqq7X7CaqjDo5Aicev3Xd4wTOI1WvdBVSJMSveeQov58zLplvh8GYZ4MgAgmO41eb6dsYieutcoq7aEsWVGrFSX2sz3D8hQK1k7DtFCs+XN9H.2wslub3bADAHGrSI", "type": "string" } }, "Retry-After": { "description": "The recommended wait time in seconds before calling the endpoint again.", "schema": { "example": 300, "type": "integer" } } } }, "403": { "content": { "application/problem+json": { "example": { "detail": "Missing access scope: 'REPORTING_REPORTS_EXECUTOR_CORE_READ'", "problemId": "b8a94c7e-6d2f-4f4c-a8cb-0e5d2f68f29e", "status": 403, "title": "Unauthorized", "type": "/reporting-api/error-types/unauthorized" }, "schema": { "additionalProperties": true, "description": "Represents error data.", "properties": { "detail": { "description": "Details of the error encountered.", "minLength": 1, "type": "string" }, "errors": { "description": "Validation errors for the provided request.", "items": { "additionalProperties": true, "properties": { "detail": { "description": "Details of the error.", "minLength": 1, "type": "string" }, "problemId": { "description": "ID assigned to this problem.", "minLength": 1, "type": "string" }, "title": { "description": "Short title identifying the error.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies which part of the request the error corresponds to.", "minLength": 1, "type": "string" } }, "required": [ "type", "title", "detail" ], "type": "object" }, "minItems": 1, "type": "array" }, "problemId": { "description": "ID assigned to this problem.", "minLength": 1, "type": "string" }, "status": { "description": "HTTP status code.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "Short title identifying the error.", "minLength": 1, "type": "string" } }, "required": [ "title", "status" ], "type": "object" } } }, "description": "You are unauthorized to make calls to the requested report." }, "404": { "content": { "application/problem+json": { "example": { "detail": "Report definition '/delivery/traffic/incorrectReport' not found", "problemId": "e1c2d7f5-9b3a-4a6e-8c9d-2f4b1e8c7a9d", "status": 404, "title": "Report not found", "type": "/reporting-api/error-types/report-not-found" }, "schema": { "additionalProperties": true, "description": "Represents error data.", "properties": { "detail": { "description": "Details of the error encountered.", "minLength": 1, "type": "string" }, "errors": { "description": "Validation errors for the provided request.", "items": { "additionalProperties": true, "properties": { "detail": { "description": "Details of the error.", "minLength": 1, "type": "string" }, "problemId": { "description": "ID assigned to this problem.", "minLength": 1, "type": "string" }, "title": { "description": "Short title identifying the error.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies which part of the request the error corresponds to.", "minLength": 1, "type": "string" } }, "required": [ "type", "title", "detail" ], "type": "object" }, "minItems": 1, "type": "array" }, "problemId": { "description": "ID assigned to this problem.", "minLength": 1, "type": "string" }, "status": { "description": "HTTP status code.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "Short title identifying the error.", "minLength": 1, "type": "string" } }, "required": [ "title", "status" ], "type": "object" } } }, "description": "The requested resource doesn't exist." }, "422": { "content": { "application/problem+json": { "example": { "detail": "Exceeded limit of maximum query cost", "problemId": "e7dc1d22-9136-487d-9808-9e1e8sb3b67c", "status": 422, "title": "Query cost exceeded", "type": "/reporting-api/error-types/query-cost-exceeded" }, "schema": { "additionalProperties": true, "description": "Represents error data.", "properties": { "detail": { "description": "Details of the error encountered.", "minLength": 1, "type": "string" }, "errors": { "description": "Validation errors for the provided request.", "items": { "additionalProperties": true, "properties": { "detail": { "description": "Details of the error.", "minLength": 1, "type": "string" }, "problemId": { "description": "ID assigned to this problem.", "minLength": 1, "type": "string" }, "title": { "description": "Short title identifying the error.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies which part of the request the error corresponds to.", "minLength": 1, "type": "string" } }, "required": [ "type", "title", "detail" ], "type": "object" }, "minItems": 1, "type": "array" }, "problemId": { "description": "ID assigned to this problem.", "minLength": 1, "type": "string" }, "status": { "description": "HTTP status code.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "Short title identifying the error.", "minLength": 1, "type": "string" } }, "required": [ "title", "status" ], "type": "object" } } }, "description": "The request cannot be processed, since its cost exceeds the maximum request cost limit." }, "429": { "content": { "application/problem+json": { "example": { "detail": "You reached the limit for request count of 20. Once your current requests are processed, the allowed request count will refill at the rate of 20 per 1 minute(s).", "problemId": "4e3d2b1a-f9c8-4b7a-a6d5-e2f1c0b9a8d7", "rateLimit": "20", "rateLimitNextRequest": "Fri, 29 Mar 2024 13:40:00 Z", "rateLimitRefill": "20", "rateLimitRemaining": "0", "status": 429, "title": "Rate Limit Exceeded", "type": "/reporting-api/error-types/rate-limit-exceeded" }, "schema": { "additionalProperties": true, "description": "Represents error data.", "properties": { "detail": { "description": "Details of the error encountered.", "minLength": 1, "type": "string" }, "errors": { "description": "Validation errors for the provided request.", "items": { "additionalProperties": true, "properties": { "detail": { "description": "Details of the error.", "minLength": 1, "type": "string" }, "problemId": { "description": "ID assigned to this problem.", "minLength": 1, "type": "string" }, "title": { "description": "Short title identifying the error.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies which part of the request the error corresponds to.", "minLength": 1, "type": "string" } }, "required": [ "type", "title", "detail" ], "type": "object" }, "minItems": 1, "type": "array" }, "problemId": { "description": "ID assigned to this problem.", "minLength": 1, "type": "string" }, "status": { "description": "HTTP status code.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "Short title identifying the error.", "minLength": 1, "type": "string" } }, "required": [ "title", "status" ], "type": "object" } } }, "description": "Hit or cost based limits exceeded." } }, "summary": "Get asynchronous report results", "tags": [ "Report data" ] }, "parameters": [ { "description": "The area of products.", "in": "path", "name": "productFamily", "required": true, "schema": { "example": "delivery", "type": "string" } }, { "description": "The grouping of reports related to the same area.", "in": "path", "name": "reportingArea", "required": true, "schema": { "example": "traffic", "type": "string" } }, { "description": "An individual report name.", "in": "path", "name": "report", "required": true, "schema": { "example": "current", "type": "string" } }, { "description": "Unique identifier of the previous asynchronous request to fetch report data.", "in": "path", "name": "queryId", "required": true, "schema": { "example": ".kRGhlJDQv5gD34L8J+bfDLmmm6tIipFMHeve7o2udsr1mxoqQ6yHbaNjw43lIyzGX0Pko3ZcsSdFU4iEvETAogoL2ijtS3D385hhKIeQ9fOlgLixkCg9em001KtQIkI3JUCX5RxxkfK3iqBNai0988XYgPEUSpQt69D5gedOjrDMch4Vy.WRpOMQEXqURxrkXSOFVVIw0yDM62VJ8sRG3fsADRpYvpnsOeFz5Eko6lHH0TqzadAXFJEHQzS25Gu", "type": "string" } } ] } }, "servers": [ { "url": "https://{hostname}/reporting-api/v2" } ], "tags": [ { "description": "Run reports to get data about your Akamai services.", "name": "Report data" } ], "x-readme": { "samples-languages": [ "curl", "python", "node" ], "explorer-enabled": true, "proxy-enabled": true } } ``` # Sibling pages * [Generate a report](https://techdocs.akamai.com/reporting/reference/post-report-data.md)