# GetBandwidthAnalytics

This operation is an extension to the standard S3 API, and is implemented to provide more information to the about their usage.

### Request <a href="#request" id="request"></a>

```http
GET /?bandwidthAnalytics&fromDate=FromDate&toDate=ToDate HTTP/1.1
```

### Response

**Headings**

The response can only contain [general headers](https://docs.petabox.io/http-api-compatible-with-amazon-s3/api-reference/common-response-headers) .

**Response codes**

For a list of possible answers, see the [Answers](https://docs.petabox.io/http-api-compatible-with-amazon-s3/api-reference/answers) section .

The successful response contains additional data in XML format, the schema of which is described below.

**Data schema**

```markup
<?xml version="1.0" encoding="UTF-8"?>
<BandwidthAnalytics>
  <Record>
    <Date>2021-08-13</Date>
    <UploadBandwidth>0</UploadBandwidth>
    <UploadBandwidthReadable>0 B</UploadBandwidthReadable>
    <DownloadBandwidth>15000000</DownloadBandwidth>
    <DownloadBandwidthReadable>15 MB</DownloadBandwidthReadable>
  </Record>
  ...
</BandwidthAnalytics>
```

| Element                     | Description                                                                                                                                                       |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `BandwidthAnalytics`        | Root element.                                                                                                                                                     |
| `Record`                    | Array of records of analytics. There is only one record for a day, but if no bandwidth was used for a specific day then no record for that day will be available. |
| `Date`                      | Date of the record                                                                                                                                                |
| `UploadBandwidth`           | Upload bandwidth represented as bytes.                                                                                                                            |
| `UploadBandwidthReadable`   | Readable upload bandwidth.                                                                                                                                        |
| `DownloadBandwidth`         | Download bandwidth represented as bytes.                                                                                                                          |
| `DownloadBandwidthReadable` | Readable download bandwidth.                                                                                                                                      |