---
title: "List Ips"
method: GET
path: "/ips"
tags: ["IPs"]
---

# List Ips

`GET /ips`

Get all IPs belonging to the user that match the given filters.

## Query parameters

- `page` object
  - `size` integer — The size of the page
  - `number` integer — The page number to load
- `filter` object
  - `connection_id` string — ID of the IP Connection to which this IP should be attached.
  - `ip_address` string — IP adddress represented by this resource.
  - `port` integer — Port to use when connecting to this IP.

## Response `200`

Successful response with a list of IPs.

- object
  - `data` Ip[]
    - `id` string — Identifies the type of resource.
    - `record_type` string — Identifies the type of the resource.
    - `connection_id` string — ID of the IP Connection to which this IP should be attached.
    - `ip_address` string — IP adddress represented by this resource.
    - `port` integer — Port to use when connecting to this IP.
    - `created_at` string — ISO 8601 formatted date indicating when the resource was created.
    - `updated_at` string — ISO 8601 formatted date indicating when the resource was updated.
  - `meta` ConnectionsPaginationMeta
    - `total_pages` integer
    - `total_results` integer
    - `page_number` integer
    - `page_size` integer

## Other responses

- `400` — Bad request, the request was unacceptable, often due to missing a required parameter.
- `401` — Unauthorized
- `403` — The user doesn't have the required permissions to perform the requested action.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)