---
name: vpc-par-viewing
title: Viewing public address ranges
description: You can view public address ranges with the console, CLI, API, and Terraform.
last-updated: 2026-09-04
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/vpc?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Viewing public address ranges
{: #par-viewing}

You can view public address ranges with the console, CLI, API, and Terraform.
{: shortdesc}

## Viewing public address ranges in the console
{: #view-par-ui}
{: ui}

To view public address ranges in the [IBM Cloud console](https://cloud.ibm.com/login){: external}, select the **Navigation menu** ![Menu icon](../icons/icon_hamburger.svg), then click **Infrastructure** ![VPC icon](../../icons/vpc.svg) > **Network** > **Public address ranges**.

The Public address ranges for VPC page shows the following information:

- **Name:** The name of the public address range object.
- **Status:** States whether the address range is bound or unbound to the specified VPC.
- **Lifecycle state:** States whether the binding or unbinding of the address range is successful, and if it is stable or not.
- **IP range:** The range of IP addresses included in the address range.
- **Zone:** States the zone that the address range is bound to (if applicable).
- **Target resource:** States the VPC that the address range is bound to in the previous zone (if applicable).



## Viewing public address ranges from the CLI
{: #par-view-cli}
{: cli}

To view public address ranges from the command line, follow these steps:

1. [Set up your CLI environment](https://cloud.ibm.com/docs/vpc?topic=vpc-set-up-environment&interface=cli&format=markdown).
1. Log in to your CLI environments. After you enter the password, the system prompts which account and region that you want to use:

   ```sh
   ibmcloud login --sso
   ```
   {: pre}

1. Run the following command:

   
   ```sh
   ibmcloud is public-address-range PUBLIC_ADDRESS_RANGE [--output JSON] [-q, --quiet]
   ```
   
   

   Where:

   `PUBLIC_ADDRESS_RANGE`
   :   The ID or name of the public address range to view.

   

   `--output`
   :   The output format, only JSON is supported. One of: JSON.

   `-q, --quiet`
   :   Suppress verbose output.
   

### Command examples
{: #par-cli-view-examples}

View the public address range `$par-id`:

```sh
ibmcloud is public-address-range $par-id
```
{: pre}



View all public address ranges:

```sh
ibmcloud is public-address-ranges
```
{: pre}








## Viewing public address ranges with the API
{: #par-view-api}
{: api}

Before you begin, set up your [API environment](https://cloud.ibm.com/docs/vpc?topic=vpc-set-up-environment&format=markdown#api-prerequisites-setup).
{: requirement}

Select one of the following options:

* View all public address ranges for an account:

   ```sh
   curl -sX GET \
            "$vpc_api_endpoint/v1/public_address_ranges?version=$api_version&generation=2" \
            -H "Authorization: Bearer $iam_token"
   ```
   {: pre}





* View a specific public address range:

   ```sh
   curl -sX GET \
            "$vpc_api_endpoint/v1/public_address_ranges/$par_id?version=$api_version&generation=2" \
            -H "Authorization: Bearer $iam_token"
   ```
   {: pre}

## Viewing public address ranges with Terraform
{: #par-view-terraform}
{: terraform}

To view a public address range with Terraform, use the following example:

```terraform

data "ibm_is_public_address_range" "public_address_range_instance" {
  name = "example-public-address-range"
}
data "ibm_is_public_address_range" "public_address_range_instance1" {
  # name = "example-public-address-range"
  identifier =  ibm_is_public_address_range.public_address_range_instance.id
}
```
{: codeblock}

To get a list of public address ranges:

```terraform
data "ibm_is_public_address_ranges" "public_address_range_instances_example_testing" {
}
```
{: pre}

## Next steps
{: #after-view-par}

- [Delete a public address range](https://cloud.ibm.com/docs/vpc?topic=vpc-par-deleting&format=markdown).