---
title: "List Elastic IPs"
method: GET
path: "/elastic-ip"
tags: ["elastic-ip"]
---

# List Elastic IPs

`GET /elastic-ip`

## Request

- Base URL: `https://api-ch-gva-2.exoscale.com/v2`
- URL: `https://api-ch-gva-2.exoscale.com/v2/elastic-ip`
- Auth: none declared
- TypeScript: <https://skmtc.dev/exoscale/apis/exoscale-api/docs/elastic-ip/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

200

- object
  - `elastic-ips` ElasticIp[]
    - `id` string, uuid: Elastic IP ID
    - `ip` string: Elastic IP address
    - `addressfamily` 'inet4' | 'inet6': Elastic IP address family
    - `cidr` string: Elastic IP cidr
    - `description` string: Elastic IP description
    - `healthcheck` ElasticIpHealthcheck: Elastic IP address healthcheck
      - `strikes-ok` integer: Number of attempts before considering the target healthy (default: 2)
      - `tls-skip-verify` boolean: Skip TLS verification
      - `tls-sni` string: An optional domain or subdomain to check TLS against
      - `strikes-fail` integer: Number of attempts before considering the target unhealthy (default: 3)
      - `mode` 'tcp' | 'http' | 'https', required: Health check mode
      - `port` integer, required: Health check port
      - `uri` string: An endpoint to use for the health check, for example '/status'
      - `interval` integer: Interval between the checks in seconds (default: 10)
      - `timeout` integer: Health check timeout value in seconds (default: 2)
    - `labels` Labels

## Changes

- **2023-02-03** `6e9809fd1444`: 1 breaking, 3 info
  - the `elastic-ips/items/ip` response's property format changed from `ipv4` to no format for status `200`
  - added the optional property `elastic-ips/items/addressfamily` to the response with the `200` status
  - added the optional property `elastic-ips/items/cidr` to the response with the `200` status
  - added the optional property `elastic-ips/items/labels` to the response with the `200` status

[Operation history](https://skmtc.dev/exoscale/apis/exoscale-api/changes/elastic-ip/get.md)

---

[API](https://skmtc.dev/exoscale/apis/exoscale-api.md) - [All operations](https://skmtc.dev/exoscale/apis/exoscale-api/llms.txt) - [OpenAPI document](https://skmtc.dev/exoscale/apis/exoscale-api/revisions/63da6f74c845?raw)