# Query the IP address (/en/api-reference/api-ref/rtc/query-ip-address)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

Retrieves Agora Notifications service server IP addresses.

- OpenAPI: /openapi/rtc/channel-management.en.yaml
- Operation ID: cma-query-ip-address
- Method: GET
- Path: /v2/ncs/ip

## Servers

- https://api.agora.io

## Parameters

- `Content-Type` (header, optional) - The request content type. Use `application/json`.
- `Accept` (header, optional) - The response content type. Use `application/json`.

## Request body

No request body.

## Responses

### 200

A `200` status code indicates success. The response body contains the result of the request.

- `data` (object)
  - `data.service` (object)
    - `data.service.hosts` (array) - A list of NCS server host objects.

A list of Agora Notifications service server host objects.
      - `data.service.hosts.items` (object)
        - `data.service.hosts.items.primaryIP` (string) - The IP address of the NCS server. Add all IP addresses returned in this field to your firewall allowlist.

The IP address of the Agora Notifications service server. Add all IP addresses returned in this field to your firewall allowlist.
No schema.
### default

The request failed. See the `message` field in the response body for the reason. Refer to Response status codes for details.

No schema.