--- title: "getPublicIpInstanceList" slug: "compute-server-getpublicipinstancelist" tags: ["Server", "Public IP"] updated: 2026-09-17T10:06:00Z published: 2026-09-17T10:06:00Z canonical: "api.ncloud-docs.com/compute-server-getpublicipinstancelist" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # getPublicIpInstanceList ## Overview Get the list of public IP instances. ## Request ### Request parameters | Parameter name | Required | Type | Restrictions | Description | | --- | --- | --- | --- | --- | | isAssociated | No | Boolean | | - Assignment status You can query assigned public IPs and unassigned public IPs. Options: true \| false | | publicIpInstanceNoList.N | No | String | It can't be duplicated. | - List of public IP instance numbers to query e.g., publicIpInstanceNoList.1=937520&publicIpInstanceNoList.2=932956 | | publicIpList.N | No | List | Min: 5, Max: 15 | - Public IP list to query e.g., publicIpList.1=106.10.53.67 | | searchFilterName | No | String | | - Name of filter to search Search by filtering by public IP (publicIp) and assigned server name (associatedServerName). Options: publicIp \| associatedServerName [case-insensitive] searchFilterName is used by mapping with the searchFilterValue value shown below. e.g., searchFilterName=publicIp&searchFilterValue=106.10.53.67 e.g., searchFilterName=associatedServerName&searchFilterValue=s1669aa4e78c | | searchFilterValue | No | String | | - Filter value to search for Enter the value to be mapped to the searchFilterName value shown above. | | regionNo | No | String | | - Region number The list of public IP instances can be filtered using Region. regionNo can be obtained through the getRegionList action. | | zoneNo | No | String | | - Zone number The list of public IP instances can be filtered using zone. zoneNo can be obtained through the getZoneList action. If no filter is set, the list of all public IP addresses belonging to the zone of the Region is selected. | | pageNo | No | Integer | Min: 0, Max: 2147483647 | - Page number of the paged results The results can be paged using pageNo. | | pageSize | No | Integer | Min: 0, Max: 2147483647 | - Size of each page to be displayed when paging The results can be paged using pageSize. | | sortedBy | No | String | | - Sorted by Sort by public IP and public IP instance number. Options: publicIp (public IP) \| publicIpInstanceNo (public IP instance number) [case-insensitive] Default: publicIpInstanceNo sortedBy is used by mapping with the sortingOrder shown below. e.g., sortedBy=publicIp&sortingOrder=ascending e.g., sortedBy=publicIpInstanceNo&sortingOrder=descending | | sortingOrder | No | String | | - Sorting order Set the ascending/descending sort order of sortedBy set above. ascending \| descending [case-insensitive] Default: ascending | | responseFormatType | No | String | | - Format type of the response result Options: xml \| json Default: xml | ## Response ### Response body - [PublicIpInstanceList](/docs/en/common-apidatatype-publicipinstancelist) ## Examples ### Request example ``` GET {SERVER_API_URL}/getPublicIpInstanceList ?searchFilterName=associatedServerName &searchFilterValue=s1669aa4e78c ``` ### Response example ``` 9e27266d-049c-42c7-a04a-a884290dddb1 0 success 1 1081432 106.10.46.237 2018-11-23T18:33:45+0900 used USED NET USED state NULL NET NULL OP GEN General 1021003 s1669aa4e78c My server image copy error test 2 4294967296 53687091200 LNX64 Linux 64 Bit juhoon-kim false 106.10.46.237 10.41.3.81 tensorflow-centos-7.3-64 NSTOP Server normal stopped state NULL Server NULL OP stopped 2018-10-22T16:19:50+0900 2018-11-23T17:38:44+0900 SPSW0LINUX000066 SPSVRSSD00000003 false 106.10.51.90 3 KR-2 KR-2 Pyeongchon zone 1 1 KR Korea NET Network Storage SSD SSD STAND Standard 39995 ncloud-default-acg Default AccessControlGroup true 2018-04-09T11:12:54+0900 3 KR-2 KR-2 Pyeongchon zone 1 ```