---
title: "Get VPC information"
method: GET
path: "/project/{project}/vpcs/{project_vpc_id}"
tags: ["Project"]
---

# Get VPC information

`GET /project/{project}/vpcs/{project_vpc_id}`

## Path parameters

- `project` string, required
- `project_vpc_id` string, required

## Response `200`

Response

- VpcGetResponse — VpcGetResponse
  - `cloud_name` string, required — Target cloud
  - `create_time` string, required — VPC creation timestamp
  - `errors` object[] — List of errors occurred during request processing
    - `message` string, required — Printable error message
    - `more_info` string — URL to the documentation of the error
    - `status` integer, required — HTTP error status code
  - `message` string — Printable result of the request
  - `network_cidr` string, required — IPv4 network range CIDR
  - `peering_connections` object[], required — List of peering connections
    - `create_time` string, required — VPC peering connection creation timestamp
    - `peer_azure_app_id` string, required — Azure app registration id in UUID4 form that is allowed to create a peering to the peer vnet
    - `peer_azure_tenant_id` string, required — Azure tenant id in UUID4 form
    - `peer_cloud_account` string, required — AWS account ID, GCP project ID, Azure subscription ID of the peered VPC, or string "upcloud" for UpCloud peering connections
    - `peer_region` string — The peer VPC's region in AWS clouds. Always null in GCP, Azure, or UpCloud clouds
    - `peer_resource_group` string, required — Azure resource group name of the peered VPC
    - `peer_vpc` string, required — AWS VPC ID, GCP VPC network name, Azure Virtual network name of the peered VPC, or UpCloud VPC ID
    - `peering_connection_id` string — VPC peering connection ID
    - `state` 'ACTIVE' | 'APPROVED' | 'APPROVED_PEER_REQUESTED' | 'DELETED' | 'DELETED_BY_PEER' | 'DELETING' | 'ERROR' | 'INVALID_SPECIFICATION' | 'PENDING_PEER' | 'REJECTED_BY_PEER', required — Project VPC peering connection state
    - `state_info` object, required — State-specific help or error information
      - `message` string, required — Human-readable information message
      - `type` string, required — Type of state information
      - `warnings` object[] — List of warnings if any
        - `conflicting_aws_account_id` string — AWS account id of conflicting VPC
        - `conflicting_aws_vpc_id` string — VPC id which is conflicting with the current one
        - `conflicting_aws_vpc_peering_connection_id` string — AWS VPC connection id which is conflicting with current VPC
        - `message` string, required — Warning message to be shown to the user
        - `type` 'overlapping-peer-vpc-ip-ranges' | 'upcloud-peering-in-error', required — Type of warning
    - `update_time` string, required — Timestamp of last change to the VPC peering connection
    - `user_peer_network_cidrs` string[], required — List of private IPv4 ranges to route through the peering connection
    - `vpc_peering_connection_type` 'aws-tgw-vpc-attachment' | 'aws-vpc-peering-connection' | 'azure-vnet-peering' | 'do-vpc-peering' | 'google-vpc-peering' | 'upcloud-vpc-peering', required — Type of network connection from the VPC
  - `pending_build_only_peering_connections` string — VPC rebuild is scheduled
  - `project_vpc_id` string, required — Project VPC ID
  - `state` 'ACTIVE' | 'APPROVED' | 'DELETED' | 'DELETING', required — Project VPC state
  - `update_time` string, required — Timestamp of last change to VPC

---

[API](https://skmtc.net/aiven/apis/aiven-api-documentation.md) · [All operations](https://skmtc.net/aiven/apis/aiven-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aiven/aiven-api-documentation/versions/ecaeabf1da31/schema)