> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cocoondata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# <content-service>/api/v1/plans/usage

## URL structure&#x20;

```text theme={null}
https://content-service.xy-company.com/api/v1/plans/usage
```

## Supported methods and overview&#x20;

* `GET` - used to retrieve information about the utilization of storage managed by the Covata Platform's Content Service.

> [!NOTE]
>
> This method takes no parameters.

## Detailed description&#x20;

This API endpoint retrieves information about the utilization of storage managed by the Covata Platform's Content Service.

This information is broken down into the total number of bytes of storage utilized by:

* All [Secure Objects](/3.2/api/creating-files-and-folders.md#secure-object)' encrypted data in storage, as well as
* All *read-only view* data for Secure Objects whose file types (determined by file name extension) support the generation of read-only views.

## Supported roles&#x20;

This API endpoint supports the following Covata user roles (as described in the [Covata Platform Administrator's Guide](/3.2/admin.md)):

* System administrator

The Covata Platform's resources available to one of these Covata users (above) is determined by the access token passed in the [header](/3.2/api/content-service-api-v1-plans-usage.md#content-service-api-v1-plans-usage-required-headers) of requests to this endpoint.

## Required headers&#x20;

The appropriate access token as the `Bearer` token:

* `Authorization: Bearer a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`

## Returns&#x20;

A JSON-formatted response containing the following members:

* **diskStorage** - A member containing information about total storage utilized by the Covata Platform's Content Service. This member contains the following sub-members:

  * **total** - The total amount of space (in bytes) of all Secure Objects' encrypted data in storage (managed by the Content Service).
  * **viewTotal** - The total amount of space (in bytes) of all Secure Objects' encrypted *read-only view* data in storage (managed by the Content Service).

  **Example:**

  ```json theme={null}
  {
    "diskStorage": {
      "total": "105957104",
      "viewTotal": "17406912"
    }
  }
  ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.