# Return resource usage and custom statistics

This function retrieves resource usage and custom statistics for a cPanel user account.

Endpoint: GET /ResourceUsage/get_usages
Version: 11.134.0.5
Security: BasicAuth

## Response 200 fields (application/json):

  - `apiversion` (integer)
    The version of the API.
    Example: 3

  - `func` (string)
    The name of the method called.
    Example: "get_usages"

  - `module` (string)
    The name of the module called.
    Example: "ResourceUsage"

  - `result` (object)

  - `result.data` (array)
    An array of objects containing resource usage information from the account's query.

  - `result.data.description` (string)
    The resource's UI display name.
    Example: "MySQL® Databases"

  - `result.data.error` (string,null)
    An error message, if applicable.

  - `result.data.formatter` (any)
    The resource's defined output format.

* 
* 
* 
*  — No defined output format.



Third-party modules will return their defined formatter value.
    Example: "format_bytes"

  - `result.data.id` (string)
    The resource's reference name.
* 
Display File Usage information in the cPanel stats barDisplayTweak SettingsWHM >> Home >> Server Configuration >> Tweak Settings*).
* 
*  - This function  returns this value if [PostgreSQL® databases](https://go.cpanel.net/cpaneldocsPostgreSQLDatabases) are enabled.
* 
* 
* 
* 
* 
Service ManagerWHM >> Home >> Service Configuration >> Service Manager*).
* 
* 
* 
*  - This function  returns this value if FTP accounts exist on the server.
*  - This function  returns this value if MySQL® databases are enabled.
* 



Certain  values may  appear, based on the [server's current profile](https://go.cpanel.net/howtouseserverprofiles#profiles).
    Example: "mysql_databases"

  - `result.data.maximum` (integer,null)
    The resources's maximum usage value.



 This function returns an null value for an (unlimited) quota.
    Example: 15

  - `result.data.url` (string)
    The resource's defined URL link to its corresponding interface, in applicable.
    Example: "sql/index.html"

  - `result.data.usage` (integer)
    The resource's current usage value.

  - `result.errors` (array,null)
    List of errors if the API failed.

  - `result.messages` (array,null)
    List of messages generated by the API.

  - `result.metadata` (object)

  - `result.status` (integer)
    -  - Success.
-  - Failed. Check the errors field for more details.
    Enum: 0, 1

  - `result.warnings` (array,null)
    List of warnings generated by the API. Warnings describe non-critical failures or other problematic conditions noted while running an API.