# GetStatistics

Returns overall usage statistics.

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>

```
GET /?statistics 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"?>
<Statistics>
  <BucketsCount>4</BucketsCount>
  <ObjectsCount>12</ObjectsCount>
  <UsedStorage>
    <UsedStorageBytes>271242929</UsedStorageBytes>
    <UsedStorageReadableQuantity>271</UsedStorageReadableQuantity>
    <UsedStorageReadableUnit>MB</UsedStorageReadableUnit>
  </UsedStorage>
  <Bandwidth>
    <BandwidthBytes>271242929</BandwidthBytes>
    <BandwidthReadableQuantity>271</BandwidthReadableQuantity>
    <BandwidthReadableUnit>MB</BandwidthReadableUnit>
  </Bandwidth>
</Statistics>
```

| Element                       | Description                                         |
| ----------------------------- | --------------------------------------------------- |
| `Statistics`                  | Root element.                                       |
| `BucketsCount`                | Number of buckets.                                  |
| `ObjectsCount`                | Overall number of objects in all owned buckets.     |
| `UsedStorage`                 | Used disk storage.                                  |
| `UsedStorageBytes`            | Used storage size represented as bytes.             |
| `UsedStorageReadableQuantity` | Quantity of used storage readable representation.   |
| `UsedStorageReadableUnit`     | Unit of used storage readable representation.       |
| `Bandwidth`                   | Used bandwidth.                                     |
| `BandwidthBytes`              | Used bandwidth represented as bytes.                |
| `BandwidthReadableQuantity`   | Quantity of used bandwidth readable representation. |
| `BandwidthReadableUnit`       | Unit of used bandwidth readable representation.     |