---
title: "Retrieve IP ranges"
method: GET
path: "/meta/network-origins/2026-03/ip-ranges"
tags: ["Basic"]
---

# Retrieve IP ranges

`GET /meta/network-origins/2026-03/ip-ranges`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/meta/network-origins/2026-03/ip-ranges`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `hapikey`
  - none

Retrieve a collection of IP ranges associated with specific services and directions, such as `EMAIL`, `API`, `DNS`, or `WEB_SCRAPING`. The response includes details like CIDR notation, description, and the direction of IP traffic.

## Query parameters

- `direction` string[]
- `service` string[]

## Response `200`

successful operation

- MetaOriginsCollectionResponseIpRangeNoPaging
  - `results` MetaOriginsIpRange[], required: An array of IpRange objects, each representing a specific IP range with associated details such as CIDR, direction, service, and description.
    - `cidr` string, required: The CIDR notation representing the IP range.
    - `description` string, required: A description of the IP range.
    - `direction` 'EGRESS' | 'INGRESS', required: The direction of the IP traffic, which can be INGRESS or EGRESS.
    - `service` 'API' | 'DNS' | 'EMAIL' | 'TEST_SERVICE' | 'WEB_SCRAPING', required: The service associated with the IP range, such as EMAIL, API, DNS, or WEB_SCRAPING.

## Other responses

- `default`: An error occurred.

## Changes

> 14 revisions in range; 1 not diffed, 2 could not be searched.

- **2026-04-08** `b0d8bc008db9`: 1 info
  - api operation id `get-/meta/network-origins/2026-03/ip-ranges_/meta/network-origins/2025-09/ip-ranges` removed and replaced with `get-/meta/network-origins/2026-03/ip-ranges`
- **2026-03-30** `dc2fdad57f7f`: 1 warning, 2 info
  - added the new `TEST_SERVICE` enum value to the `results/items/service` response property for the response status `200`
  - api operation id `get-/meta/network-origins/2026-03/ip-ranges_/meta/network-origins/2026-03/ip-ranges` removed and replaced with `get-/meta/network-origins/2026-03/ip-ranges_/meta/network-origins/2025-09/ip-ranges`
  - added the enum value `TEST_SERVICE` to the property `items/` of the `query` request parameter `service`
- **2026-03-25** `37a93e10d5c4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hubspot/apis/hubspot-api-specification/changes/meta/network-origins/2026-03/ip-ranges/get.md)

---

[API](https://skmtc.dev/hubspot/apis/hubspot-api-specification.md) - [All operations](https://skmtc.dev/hubspot/apis/hubspot-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/hubspot-api-specification/revisions/f9c7181056c5?raw)