---
title: "Suggest non-overlapping CIDR blocks"
method: GET
path: "/api/v1/vpcs/cidr-suggestions"
tags: ["Networking"]
---

# Suggest non-overlapping CIDR blocks

`GET /api/v1/vpcs/cidr-suggestions`

Returns suggested CIDR blocks that don't overlap with the account's existing VPCs.
Use one of these as `cidr` when creating a new VPC.

## Headers

- `X-Project-ID` string, uuid, required

## Response `200`

CIDR suggestions

- CIDRSuggestionsResponse
  - `success` boolean, required
  - `suggested` string — Recommended CIDR — non-overlapping and right-sized for typical use.
  - `suggested_ips` integer — Number of usable IPs in the suggested block.
  - `alternatives` CIDRSuggestion[] — Other non-overlapping CIDRs to choose from, sized small/medium/large.
    - `cidr` string
    - `available_ips` integer
    - `size` 'small' | 'medium' | 'large'
  - `existing_count` integer — Number of VPCs you already have.

## Other responses

- `401` — Authentication required

## Changes

- **2026-05-06** `9e13a6e23934` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rafftechnologies/apis/raff-api/changes/api/v1/vpcs/cidr-suggestions/get.md)

---

[API](https://skmtc.dev/rafftechnologies/apis/raff-api.md) · [All operations](https://skmtc.dev/rafftechnologies/apis/raff-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rafftechnologies/raff-api/revisions/2f4df56be77c/schema)