---
updatedAt: 2026-09-23T15:29:37.000Z
agentTools:
  projectIndex: https://docs.greynoise.io/llms.txt
---

# v2 - v3 API Migration Matrix

As of 28-Jul-2025, all v2 API endpoints for the GreyNoise API have been deprecated.  The following matrix helps users identify which new v3 API endpoints replace the existing v2 endpoints.

> ❗️ v2 Endpoints will be Decomissioned on 30-Apr-2026

> 📘 End of Life
>
> All endpoints with a new replacment endpoint indicated or noted as being Deprecated will be End of Life (no longer available) as of 1-Jan-2026.

# IP Lookup

| Old Endpoint            | Replaced By           | Brief Description                                        |
| :---------------------- | :-------------------- | :------------------------------------------------------- |
| /v2/noise/multi/context | /v3/ip                | Multi IP lookup (Combined Response)                      |
| /v2/noise/multi/quick   | /v3/ip?quick=true     | Multi IP lookup with quick response (Combined Response)  |
| /v2/noise/context/:ip   | /v3/ip/:ip            | Single IP lookup(Combined Response)                      |
| /v2/riot/:ip            | /v3/ip/:ip            | Single IP lookup(Combined Response)                      |
| /v2/noise/quick/:ip     | /v3/ip/:ip?quick=true | Single IP lookup with quick response (Combined Response) |

> 📘 Combined Response
>
> Previous endpoints only returned data from a single data set.  The new v3 endpoints now offer a combined response that pulls all known data from all datasets into a single response.

# GNQL Search

| Old Endpoint                | Replaced By       | Brief Description                                              |
| :-------------------------- | :---------------- | :------------------------------------------------------------- |
| /v2/experimental/gnql       | /v3/gnql          | Full GNQL query search (Combined Response)                     |
| N/A                         | /v3/gnql/metadata | GNQL query Search with metadata fields only (Combined Response |
| /v2/experimental/gnql/stats | /v3/gnql/stats    | Stats based on GNQL query                                      |

# CVE Lookup

| Old Endpoint | Replaced By | Brief Description |
| :----------- | :---------- | :---------------- |
| /v1/cve/:cve | N/A         | Single CVE search |
| N/A          | /v3/cves    | Bulk CVE search   |

# Utility

| Old Endpoint      | Replaced By | Brief Description |
| :---------------- | :---------- | :---------------- |
| /v2/meta/metadata | /v3/tags    | Tag Lookups       |
| /ping             | Unchanged   |                   |

# Community API

| Old Endpoint      | Replaced By | Brief Description                  |
| :---------------- | :---------- | :--------------------------------- |
| /v3/community/:ip | /v3/ip/:ip  | Follows free account weekly limits |

# IP Timeline

| Old Endpoint                     | Replaced By    | Brief Description |
| :------------------------------- | :------------- | :---------------- |
| /v3/noise/ips/:ip/timeline       | Unchanged      |                   |
| /v3/noise/ips/:ip/daily-summary  | **DEPRECATED** | **DEPRECATED**    |
| /v3/noise/ips/:ip/hourly-summary | **DEPRECATED** | **DEPRECATED**    |

# IP Similarity

| Old Endpoint                   | Replaced By    | Brief Description |
| :----------------------------- | :------------- | :---------------- |
| /v3/similarity/ips/:ip         | **DEPRECATED** | **DEPRECATED**    |
| /v3/similarity/ips/:ip/export  | **DEPRECATED** | **DEPRECATED**    |
| /v3/similarity/ips/:ip/compare | **DEPRECATED** | **DEPRECATED**    |

> 📘 Updated Dataset Names
>
> Former endpoints would reference the Noise and RIOT data sets.  Those have been rebranded as:\
> Noise = Internet Scanner Intelligence
> RIOT = Business Service Intelligence