---
title: Floating IPs
description: DigitalOcean [Reserved IP addresses](https://www.digitalocean.com/docs/networking/floating-ips/) are publicly-accessible static IP addresses that you …
product: Reference
url: https://docs.digitalocean.com/reference/api/metadata/floating-ips/
---

> **For AI agents:** The documentation index is at [https://docs.digitalocean.com/llms.txt](https://docs.digitalocean.com/llms.txt). Markdown versions of pages use the same URL with `index.html.md` in place of the HTML page (for example, append `index.html.md` to the directory path instead of opening the HTML document).

# Floating IPs

Generated on 15 Sep 2026

DigitalOcean [Reserved IP addresses](https://www.digitalocean.com/docs/networking/floating-ips/) are publicly-accessible static IP addresses that you can assign to Droplets and instantly remap between other Droplets in the same datacenter.

Base URL `http://169.254.169.254`

## Endpoints

- **GET** [Get Floating IP Index](#getFloatingIp)
- **GET** [Get Floating IPv4 Attributes Index](#getFloatingIpIpv4)
- **GET** [Get Floating IPv4 Status](#getFloatingIpIpv4Active)
- **GET** [Get Floating IPv4 Address](#getFloatingIpIpv4Address)

## GET Get Floating IP Index

`/metadata/v1/floating_ip/`

An index of IPv4 Floating IPs.

##### Request: `/metadata/v1/floating_ip/`

### cURL

```bash
curl -X GET \
  "http://169.254.169.254/metadata/v1/floating_ip/"
```

#### Responses

200

Success

##### Response

```
ipv4/
```

* * *

## GET Get Floating IPv4 Attributes Index

`/metadata/v1/floating_ip/ipv4/`

An index of IPv4 Floating IP attributes.

##### Request: `/metadata/v1/floating_ip/ipv4/`

### cURL

```bash
curl -X GET \
  "http://169.254.169.254/metadata/v1/floating_ip/ipv4/"
```

#### Responses

200

Success

##### Response

```
active
ip_address
```

* * *

## GET Get Floating IPv4 Status

`/metadata/v1/floating_ip/ipv4/active`

Displays true if a Floating IP is currently assigned to the Droplet and false if it is not.

##### Request: `/metadata/v1/floating_ip/ipv4/active`

### cURL

```bash
curl -X GET \
  "http://169.254.169.254/metadata/v1/floating_ip/ipv4/active"
```

#### Responses

200

Success

##### Response

```
true
```

* * *

## GET Get Floating IPv4 Address

`/metadata/v1/floating_ip/ipv4/ip_address`

The IP address of the Floating IP that is currently assigned to the Droplet.

##### Request: `/metadata/v1/floating_ip/ipv4/ip_address`

### cURL

```bash
curl -X GET \
  "http://169.254.169.254/metadata/v1/floating_ip/ipv4/ip_address"
```

#### Responses

200

Success

##### Response

```
45.55.96.17
```

* * *

Learn more: [How to Find Information about Droplet Anchor IPs](https://docs.digitalocean.com/products/networking/reserved-ips/how-to/find-anchor-ips/index.html.md), [Reserved IPs Pricing](https://docs.digitalocean.com/products/networking/reserved-ips/details/pricing/index.html.md), [How to Send Outbound Traffic Over a Reserved IP](https://docs.digitalocean.com/products/networking/reserved-ips/how-to/outbound-traffic/index.html.md)