List network zones

View as Markdown
GET
/network_zones

Retrieves a paginated list of network zones across all types (IP and regional). Each item is discriminated by its type field. Optional query parameters may be used to search, filter, and sort the results.

Authorization

API-Key
headerX-API-KEY<token>

MonoCloud APIs require authentication with an API key. Retrieve your key from the Tenant Settings section of the MonoCloud dashboard and include it in the request header as: X-API-Key: <your_api_key>

Query Parameters

page?integer

The page number to retrieve.

Formatint32
Range1 <= value
Default1
size?integer

The number of zones to return per page.

Formatint32
Range1 <= value <= 50
Default10
filter?string

Optional Lucene-style filter expression used to search by attributes.

sort?string

Sort expression in the format field:direction, where direction is 1 for ascending or -1 for descending. Supported fields include - name, category, operator, type, creation_time and last_updated

Response Headers

200

x-Pagination?object

Returns the x-Pagination header

page_size*integer

Number of items returned per page.

Formatint32
current_page*integer

The current page number.

Formatint32
total_count*integer

Total number of items available.

Formatint32
has_previous*boolean

Indicates whether a previous page exists.

has_next*boolean

Indicates whether a next page exists.

Response Body

200

application/json

The network zones were retrieved successfully

TypeScript Definitions

Use the response body type in TypeScript.

Returns an array. Each item has the fields below.

Network Zone Response: Represents a Network Zone (IP or Regional).

IP Network Zone Response: Represents a IP Network Zone.

Errors

401Unauthorized
403Forbidden
curl -X GET "https://your-domain.us.monocloud.com/api/network_zones?page=1&size=10&filter=api&sort=creation_time%3A1" \  -H "X-API-KEY: <token>"

[  {    "id": "uSkOCE9ZEmYdWS7Kv223S",    "enabled": true,    "name": "Designation",    "description": "Location of the Company Headquarters",    "category": "trusted",    "creation_time": 1640975400,    "last_updated": 1640975400,    "operator": "in",    "type": "ip",    "ip_ranges": [      "156.3.59.5",      "2001:db8::/32"    ]  }]

© 2026 MonoCloud. All rights reserved.