# Return IPv6 address usage

This function retrieves usage information for IPv6 addresses in an IPv6 range.



For all of cPanel & WHM's features to function properly on IPv6, the  daemon  listen on IPv6 addresses. To enable this functionality, select  for the  setting in the  section of WHM's  interface ().



When you disable the Web Server role, the system  this function.

Endpoint: GET /ipv6_range_usage
Version: 11.134.0.5
Security: BasicAuth

## Query parameters:

  - `name` (string, required)
    The IPv6 address range's name.
    Example: "TestRange"

## Response 200 fields (application/json):

  - `data` (object)

  - `data.usage` (object)
    The IPv6 address range's information.

  - `data.usage.forbidden` (integer)
    The number of reserved IPv6 addresses.
    Example: 65536

  - `data.usage.free` (integer)
    The number of available IPv6 addresses.
    Example: 1000000

  - `data.usage.used` (integer)
    The number of assigned IPv6 addresses.
    Example: 20

  - `metadata` (object)

  - `metadata.command` (string)
    The method name called.
    Example: "ipv6_range_usage"

  - `metadata.reason` (string)
    The reason the API function failed when the  field is 0. This field may display a success message when a function succeeds.
    Example: "OK"

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

  - `metadata.version` (integer)
    The version of the API function.
    Example: 1