--- updatedAt: 2026-05-07T14:06:35.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/gtm-reporting/llms.txt --- # Report traffic per data center This report shows, for a given domain and data center, the DNS requests received in each five-minute period. Requests are broken down by property. # OpenAPI definition ```json { "externalDocs": { "description": "See documentation for Akamai's Global Traffic Management Reporting API", "url": "https://techdocs.akamai.com/gtm-reporting/reference" }, "info": { "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "title": "Traffic", "version": "v1" }, "openapi": "3.0.0", "paths": { "/traffic/domains/{domain}/datacenters/{datacenterId}": { "get": { "description": "This report shows, for a given domain and data center, the DNS requests received in each five-minute period. Requests are broken down by property.", "externalDocs": { "description": "See documentation for this operation in Akamai's Global Traffic Management Reporting API", "url": "https://techdocs.akamai.com/gtm-reporting/reference/get-traffic-datacenter" }, "operationId": "get-traffic-datacenter", "parameters": [ { "description": "Start date of report, in ISO 8601 format of `YYYY-MM-DDThh:mm:ssZ` in UTC time.", "in": "query", "name": "start", "required": true, "schema": { "example": "2021-05-23T01:56:13Z", "type": "string" }, "x-akamai": { "file-path": "parameters/start-query.yaml" } }, { "description": "End date of report, in ISO 8601 format of `YYYY-MM-DDThh:mm:ssZ` in UTC time.", "in": "query", "name": "end", "required": true, "schema": { "example": "2021-05-24T01:56:13Z", "type": "string" }, "x-akamai": { "file-path": "parameters/end-query.yaml" } }, { "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": { "dataRows": [ { "properties": [ { "name": "www", "requests": 45, "status": "1" } ], "timestamp": "2021-11-23T00:00:00Z" }, { "properties": [ { "name": "www", "requests": 45, "status": "1" } ], "timestamp": "2021-11-23T00:05:00Z" } ], "links": [ { "href": "https://akab-xxxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxx.luna.akamaiapis.net/gtm-api/v1/reports/traffic/domains/example.akadns.net/datacenters?start=2021-11-23T00:00:00Z&2021-11-23T00:10:00Z", "rel": "self" } ], "metadata": { "datacenterId": 3200, "datacenterNickname": "Winterfell", "domain": "example.akadns.net", "end": "2021-11-23T00:10:00Z", "interval": "FIVE_MINUTE", "start": "2021-11-23T00:00:00Z", "uri": "https://akab-xxxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxx.luna.akamaiapis.net/gtm-api/v1/reports/traffic/domains/example.akadns.net/datacenters?start=2021-11-23T00:00:00Z&end=2021-11-23T00:10:00Z" } }, "schema": { "additionalProperties": false, "properties": { "dataRows": { "description": "The traffic data rows for the reporting period.", "items": { "additionalProperties": false, "properties": { "properties": { "description": "The properties that received traffic from this data center during this interval.", "items": { "additionalProperties": false, "properties": { "name": { "description": "The GTM property name.", "minLength": 1, "type": "string" }, "requests": { "description": "The number of DNS requests received during this interval.", "type": "number" }, "status": { "description": "The status code for this property during this interval.", "minLength": 1, "type": "string" } }, "required": [ "name", "requests", "status" ], "type": "object" }, "type": "array" }, "timestamp": { "description": "An ISO 8601 timestamp indicating when this data row was recorded.", "type": "string" } }, "required": [ "timestamp", "properties" ], "type": "object" }, "type": "array" }, "dataSummary": { "description": "Summary statistics for the report.", "type": "object" }, "links": { "description": "Hypermedia links to help navigate through the result set, or to identify the current item whose `rel` is `self`.", "items": { "additionalProperties": false, "description": "Hypermedia links to help navigate through the result set, or to identify the current item whose `rel` is `self`.", "properties": { "href": { "description": "A relative path to the currently requested object or a specific page of the result set.", "minLength": 1, "type": "string" }, "rel": { "description": "The relationship between the current and linked result sets. A value of `self` links to the current result set, while `first`, `next`, and `last` link to different sets of paginated data.", "minLength": 1, "type": "string" } }, "required": [ "href", "rel" ], "type": "object", "x-akamai": { "file-path": "schemas/links.yaml" } }, "type": "array" }, "metadata": { "additionalProperties": false, "description": "Report metadata describing the query parameters and resource URL.", "properties": { "datacenterId": { "description": "The data center ID.", "type": "integer" }, "datacenterNickname": { "description": "The data center nickname.", "minLength": 1, "type": "string" }, "domain": { "description": "The GTM domain name.", "minLength": 1, "type": "string" }, "end": { "description": "An ISO 8601 timestamp indicating when the reporting period ends.", "type": "string" }, "interval": { "description": "The reporting interval. Always `FIVE_MINUTE`.", "enum": [ "FIVE_MINUTE" ], "type": "string" }, "start": { "description": "An ISO 8601 timestamp indicating when the reporting period starts.", "type": "string" }, "uri": { "description": "The URL of this report.", "format": "uri", "type": "string" } }, "required": [ "uri", "domain", "datacenterId", "datacenterNickname", "start", "end" ], "type": "object" } }, "required": [ "metadata", "dataRows", "links" ], "type": "object", "x-akamai": { "file-path": "schemas/traffic-datacenter.yaml" } } }, "text/csv": { "example": "\"timestamp\",\"domain\",\"property\",\"datacenterId\",\"datacenterNickname\",\"requests\",\"status\"\n\"2021-03-01T20:30:00Z\",\"example.akadns.net\",\"www\",\"3132\",\"Winterfell\",\"39\",\"1\"\n\"2021-03-01T20:35:00Z\",\"example.akadns.net\",\"www\",\"3132\",\"Winterfell\",\"266\",\"1\"" } }, "description": "Successful response." } }, "summary": "Report traffic per data center", "tags": [ "Traffic" ] }, "parameters": [ { "description": "Data center ID.", "in": "path", "name": "datacenterId", "required": true, "schema": { "example": 3200, "type": "integer" }, "x-akamai": { "file-path": "parameters/datacenter-id-path.yaml" } }, { "description": "Name of Traffic Management domain.", "in": "path", "name": "domain", "required": true, "schema": { "example": "example.akadns.net", "type": "string" }, "x-akamai": { "file-path": "parameters/domain-path.yaml" } } ], "x-akamai": { "file-path": "paths/datacenter-traffic.yaml", "path-info": "/traffic/domains/{domain}/datacenters/{datacenterId}" } } }, "servers": [ { "url": "https://{hostname}/gtm-api/v1/reports" } ], "tags": [ { "description": "Provides details on DNS requests for GTM properties in a five minute period.", "name": "Traffic" } ], "x-akamai": { "auth-type": "EDGE_GRID", "file-path": "02-traffic.yaml" }, "x-readme": { "explorer-enabled": false, "samples-languages": [ "curl", "python", "node" ] } } ``` # Sibling pages * [Report traffic per property](https://techdocs.akamai.com/gtm-reporting/reference/get-traffic-property.md) * [Get a datacenter traffic report window](https://techdocs.akamai.com/gtm-reporting/reference/get-traffic-datacenters-window.md) * [Get a property traffic report window](https://techdocs.akamai.com/gtm-reporting/reference/get-traffic-properties-window.md)