---
title: "Changes to Given the ID for an upstream device, will return the upstream and the downstream relationships associated with that gateway. These downstream relationships are only those associated with the direct downstream level (they don’t work recursively)."
method: GET
path: "/devices/{deviceId}/relationships"
---

# Changes to Given the ID for an upstream device, will return the upstream and the downstream relationships associated with that gateway. These downstream relationships are only those associated with the direct downstream level (they don’t work recursively).

`GET /devices/{deviceId}/relationships`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 8 revisions.

- **2026-07-13** (1.0) `565d8813cbd3` — 1 info
- **2026-07-13** (1.0) `50c39d38d85a` — 1 breaking
- **2026-07-13** (1.0) `bcae1054dfc8` — 1 info
- **2026-07-13** (1.0) `6536da9e32d7` — 1 breaking, 1 info
- **2026-07-13** (1.0) `91b0e78f975b` — 1 breaking
- **2026-07-13** (1.0) `6626576352d6` — 1 info

## Changes

- **2026-07-13** (1.0) `565d8813cbd3` — 1 info
  - added the new optional `query` request parameter `maxpagesize`
- **2026-07-13** (1.0) `50c39d38d85a` — 1 breaking
  - api path removed without deprecation
- **2026-07-13** (1.0) `bcae1054dfc8` — 1 info
  - endpoint added
- **2026-07-13** (1.0) `6536da9e32d7` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added
- **2026-07-13** (1.0) `91b0e78f975b` — 1 breaking
  - api path removed without deprecation
- **2026-07-13** (1.0) `6626576352d6` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/azure/apis/iotcentral-iotcentral/docs/devices/:deviceId/relationships/get.md) · [API](https://skmtc.dev/azure/apis/iotcentral-iotcentral.md) · [Page](https://skmtc.dev/azure/apis/iotcentral-iotcentral/changes/devices/:deviceId/relationships/get)