---
title: "GET /projects/{project}/regions/{region}/routers/{router}/getNatIpInfo"
method: GET
path: "/projects/{project}/regions/{region}/routers/{router}/getNatIpInfo"
tags: ["routers"]
---

# GET /projects/{project}/regions/{region}/routers/{router}/getNatIpInfo

`GET /projects/{project}/regions/{region}/routers/{router}/getNatIpInfo`

## Request

- Base URL: `https://compute.googleapis.com/compute/v1`
- URL: `https://compute.googleapis.com/compute/v1/projects/{project}/regions/{region}/routers/{router}/getNatIpInfo`
- Auth: one of:
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/cloud-platform`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/compute`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/compute`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/compute.readonly`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/compute.readonly`

Retrieves runtime NAT IP information.

## Path parameters

- `project` string, required
- `region` string, required
- `router` string, required

## Query parameters

- `natName` string

## Response `200`

Successful response

- NatIpInfoResponse
  - `result` NatIpInfo[]: [Output Only] A list of NAT IP information.
    - `natIpInfoMappings` NatIpInfoNatIpInfoMapping[]: Output only. A list of all NAT IPs assigned to this NAT config.
      - `mode` 'AUTO' | 'MANUAL': Output only. Specifies whether NAT IP is auto or manual.
      - `natIp` string: Output only. NAT IP address. For example: 203.0.113.11.
      - `usage` 'IN_USE' | 'UNUSED': Output only. Specifies whether NAT IP is currently serving at least one endpoint or not.
    - `natName` string: Output only. Name of the NAT config which the NAT IP belongs to.

## Changes

- **2026-10-30** `8b85e897d3dc`: 4 info
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was added to the endpoint's security scheme `Oauth2c`
  - the security scope `https://www.googleapis.com/auth/compute.readonly` was removed from the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/compute.readonly` was removed from the endpoint's security scheme `Oauth2c`
- **2026-10-23** `48929bf89eeb`: 4 info
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was added to the endpoint's security scheme `Oauth2c`
  - the security scope `https://www.googleapis.com/auth/compute.readonly` was removed from the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/compute.readonly` was removed from the endpoint's security scheme `Oauth2c`
- …earlier changes not shown

[Operation history](https://skmtc.dev/google/apis/compute/changes/projects/:project/regions/:region/routers/:router/getNatIpInfo/get.md)

---

[API](https://skmtc.dev/google/apis/compute.md) - [All operations](https://skmtc.dev/google/apis/compute/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/compute/revisions/8b85e897d3dc?raw)
