This document describes the JSON format used to publish Cloudmersive tenant egress IP ranges via the tenant IP API. You can access your Cloudmersive Managed Instance API URL by navigation to the Cloudmersive Management Portal, selecting Managed Instances, and then selecting IP Address Feed.

Purpose

This JSON file lists the public IP addresses that Cloudmersive may use when making outbound network connections from a tenant environment.

Customers can use this list to configure firewall allowlists, network security rules, API gateways, or other inbound access controls.

Format

{
  "provider": "Cloudmersive",
  "description": "Cloudmersive Tenant Egress IPs",
  "ranges": [
    {
      "cidr": "100.100.100.100/32",
      "ipVersion": 4,
      "direction": "egress"
    }
  ]
}

Schema Overview

The file contains three top-level fields:

• provider
• description
• ranges

The ranges field is an array. Each item in the array describes one IP address or CIDR block.

Top-Level Fields

provider

The name of the service provider publishing the IP range list.

Example:

"provider": "Cloudmersive"

Required: yes

Type: string

description

A human-readable description of what the IP ranges represent.

Example:

"description": "Cloudmersive Tenant Egress IPs"

Required: yes

Type: string

ranges

An array of IP range objects.

Each object represents one IP address or CIDR block used by the provider.

Example:

"ranges": [
  {
    "cidr": "100.100.100.100/32",
    "ipVersion": 4,
    "direction": "egress"
  }
]

Required: yes

Type: array

Range Object Fields

Each item in the ranges array contains the following fields:

• cidr
• ipVersion
• direction

cidr

The IP address or subnet in CIDR notation.

For single IPv4 addresses, /32 is used.

Example:

"cidr": "100.100.100.100/32"

Required: yes

Type: string

ipVersion

The IP protocol version.

For IPv4 addresses, use:

"ipVersion": 4

For IPv6 addresses, use:

"ipVersion": 6

Required: yes

Type: number

direction

The network traffic direction represented by this range.

For Cloudmersive tenant outbound traffic, this value is:

"direction": "egress"

This means the listed IP addresses are used by Cloudmersive when connecting outbound to customer systems or third-party services.

Required: yes

Type: string