---
title: "Retrieve Elastic IP details"
method: GET
path: "/elastic-ip/{id}"
tags: ["elastic-ip"]
---

# Retrieve Elastic IP details

`GET /elastic-ip/{id}`

## Request

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

## Path parameters

- `id` string, uuid, required

## Response `200`

200

- ElasticIp: Elastic IP
  - `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 `ip` response's property format changed from `ipv4` to no format for status `200`
  - added the optional property `addressfamily` to the response with the `200` status
  - added the optional property `cidr` to the response with the `200` status
  - added the optional property `labels` to the response with the `200` status

[Operation history](https://skmtc.dev/exoscale/apis/exoscale-api/changes/elastic-ip/:id/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)