---
title: "Read an IP Filter Summary"
method: GET
path: "/iam/v2/ip-filter-summary"
tags: ["IP Filter Summaries (iam/v2)"]
---

# Read an IP Filter Summary

`GET /iam/v2/ip-filter-summary`

[![General Availability](https://img.shields.io/badge/Lifecycle%20Stage-General%20Availability-%2345c6e8)](#section/Versioning/API-Lifecycle-Policy)

Make a request to read an IP filter summary.

## Query parameters

- `scope` string, required

## Response `200`

IP Filter Summary.

- object — The IP Filter Summary endpoint returns an aggregation of the IP Filters across the system. This API can be queried in the context of an organization or an environment. It returns a summary of every operation group in the system grouped with a higher summary by operation group category.
  - `api_version` 'iam/v2', required — APIVersion defines the schema version of this representation of a resource.
  - `kind` 'IpFilterSummary', required — Kind defines the object this REST resource represents.
  - `scope` string, required — The scope associated with this object.
  - `categories` object[], required — Summary of the operation groups and IP filters created in those operation groups.
    - `name` string — Name of the category.
    - `status` string — Open, limited, or mixed.
    - `operation_groups` object[] — Operation groups part of this category.
      - `name` string — Name of the operation group.
      - `status` string — Open, limited, or no access.

## Other responses

- `400` — Bad Request
- `401` — The request lacks valid authentication credentials for this resource.
- `403` — The access credentials were considered insufficient to grant access
- `404` — Not Found
- `429` — Rate Limit Exceeded
- `500` — Oops, something went wrong!

---

[API](https://skmtc.dev/confluent/apis/confluent-cloud-apis.md) · [All operations](https://skmtc.dev/confluent/apis/confluent-cloud-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/confluent/confluent-cloud-apis/revisions/a6a73f98a698/schema)