---
title: "List all egress IPs across all VPCs and gateways in the workspace"
method: GET
path: "/egressips"
tags: ["vpcs"]
---

# List all egress IPs across all VPCs and gateways in the workspace

`GET /egressips`

## Response `200`

successful operation

- EgressIP[]
  - `events` CoreEvent[] — Events happening on a resource deployed on Blaxel
    - `canaryRevision` string — Canary revisionID link to the event
    - `message` string — Event message
    - `revision` string — RevisionID link to the event
    - `status` string — Event status
    - `time` string — Event time
    - `type` string — Event type
  - `metadata` EgressIPMetadata, required — Owner fields for Persistence
    - `createdAt` string — The date and time when the resource was created
    - `updatedAt` string — The date and time when the resource was updated
    - `createdBy` string — The user or service account who created the resource
    - `updatedBy` string — The user or service account who updated the resource
    - `displayName` string — Human-readable name for display in the UI. Can contain spaces and special characters, max 63 characters.
    - `gatewayName` string — Name of the egress gateway this IP is allocated from
    - `name` string, required — Unique identifier for the egress IP within the gateway. Must be lowercase alphanumeric with hyphens, max 49 characters. Immutable after creation.
    - `vpcName` string — Name of the VPC this egress IP belongs to
    - `workspace` string — Name of the workspace this resource belongs to (read-only, set automatically)
  - `spec` EgressIPSpec, required — Specification for an egress IP including IP family and the provisioned address
    - `ipFamily` 'IPv4' | 'IPv6', required — IP address family, either IPv4 or IPv6
    - `publicIp` string — Public IP address assigned to this egress IP (read-only, set after provisioning)
  - `status` 'DELETING' | 'TERMINATED' | 'FAILED' | 'DEACTIVATED' | 'DEACTIVATING' | 'UPLOADING' | 'BUILDING' | 'DEPLOYING' | 'DEPLOYED' | 'BUILT' — Deployment status of a resource deployed on Blaxel

---

[API](https://skmtc.net/blaxel/apis/blaxel-control-plane.md) · [All operations](https://skmtc.net/blaxel/apis/blaxel-control-plane/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blaxel/blaxel-control-plane/versions/dfa264bc72ee/schema)