---
title: "List"
method: GET
path: "/ip_restrictions"
tags: ["IPRestrictions"]
---

# List

`GET /ip_restrictions`

List all IP restrictions on this account

## Query parameters

- `before_id` string
- `limit` string
- `filter` string

## Headers

- `ngrok-version` integer, required

## Response `200`

List all IP restrictions on this account

- IPRestrictionList
  - `ip_restrictions` IPRestriction[] — the list of all IP restrictions on this account
    - `id` string — unique identifier for this IP restriction
    - `uri` string — URI of the IP restriction API resource
    - `created_at` string — timestamp when the IP restriction was created, RFC 3339 format
    - `description` string — human-readable description of this IP restriction. optional, max 255 bytes.
    - `metadata` string — arbitrary user-defined machine-readable data of this IP restriction. optional, max 4096 bytes.
    - `enforced` boolean — true if the IP restriction will be enforced. if false, only warnings will be issued
    - `type` string — the type of IP restriction. this defines what traffic will be restricted with the attached policies. four values are currently supported: `dashboard`, `api`, `agent`, and `endpoints`
    - `ip_policies` Ref[] — the set of IP policies that are used to enforce the restriction
      - `id` string — a resource identifier
      - `uri` string — a uri for locating a resource
  - `uri` string — URI of the IP restrictions list API resource
  - `next_page_uri` string — URI of the next page, or null if there is no next page

---

[API](https://skmtc.net/ngrok/apis/ngrok-openapi.md) · [All operations](https://skmtc.net/ngrok/apis/ngrok-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ngrok/ngrok-openapi/versions/1994bbb04714/schema)