# Querying Details of a Whitelist

#### Function

This API is used to query details about a whitelist using its ID.

#### URI

GET /v2.0/lbaas/whitelists/{whitelist_id}

Table 1 Parameter description
Parameter | Mandatory | Type | Description
--- | --- | --- | ---
whitelist_id | Yes | String | Specifies the whitelist ID.

#### Request

None

#### Response

Table 2 Response parameters
Parameter | Type | Description
--- | --- | ---
whitelist | Object | Specifies the whitelist. For details, see Table 3.

Table 3 whitelist parameter description
Parameter | Type | Description
--- | --- | ---
id | String | Specifies the whitelist ID.
tenant_id | String | Specifies the ID of the project where the forwarding rule is used. The value contains a maximum of 255 characters.
listener_id | String | Specifies the ID of the listener to which the whitelist is added.
enable_whitelist | Boolean | Specifies whether to enable access control. true: Access control is enabled. false: Access control is disabled.
whitelist | String | Specifies the IP addresses in the whitelist.

#### Example Request

- Example request: Querying details of a whitelist

      GET https://{Endpoint}/v2.0/lbaas/whitelists/09e64049-2ab0-4763-a8c5-f4207875dc3e

#### Example Response

- Example response

      {
          "whitelist": {
              "id": "eabfefa3fd1740a88a47ad98e132d238",
              "listener_id": "eabfefa3fd1740a88a47ad98e132d238",
              "tenant_id": "eabfefa3fd1740a88a47ad98e132d238",
              "enable_whitelist": true,
              "whitelist": "192.168.11.1,192.168.0.1/24,192.168.201.18/8,100.164.0.1/24"
          }
      }

#### Status Code

For details, see HTTP Status Codes of Shared Load Balancers.

Parent topic: Whitelist