# GetStorageAnalytics

Returns storage analytics over time.

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 /?storageAnalytics&fromDate={FromDate}&toDate={ToDate}&format={json/xml} HTTP/1.1
```

### Response

**Headings**

The response can only contain [general headers](https://docs.coldstack.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.coldstack.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"?>
<StorageUsageAnalytics>
  <Record>
    <Timestamp>2021-08-13</Timestamp>
    <UsedStorage>0</UsedStorage>
    <UsedStorageReadable>0 B</UsedStorageReadable>
  </Record>
  ...
</StorageUsageAnalytics>
```

| Element                 | Description                                                                                                                                                           |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `StorageUsageAnalytics` | Root element.                                                                                                                                                         |
| `Record`                | Array of records of analytics. There is only one record for an hour, but if no bandwidth was used for a specific hour then no record for that hour will be available. |
| `Timestamp`             | Date and hour of the record                                                                                                                                           |
| `UsedStorage`           | Used storage at that timestamp.                                                                                                                                       |
| `UsedStorageReadable`   | Used storage at that timestamp in readable format.                                                                                                                    |