---
title: "Get object descriptors related to an IP address"
method: GET
path: "/ip_addresses/{ip}/relationships/{relationship}"
---

# Get object descriptors related to an IP address

`GET /ip_addresses/{ip}/relationships/{relationship}`

## Request

- Base URL: `https://www.virustotal.com/api/v3`
- URL: `https://www.virustotal.com/api/v3/ip_addresses/{ip}/relationships/{relationship}`
- Auth: none required
- TypeScript: <https://skmtc.dev/virustotal/apis/virustotal-api-v3/docs/ip_addresses/:ip/relationships/:relationship/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `ip` string, required
- `relationship` string, required

## Query parameters

- `limit` string
- `cursor` string

## Headers

- `x-apikey` string, required

## Response `200`

200

- object

## Other responses

- `400`: 400

---

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