---
title: "GET /digitaltwins/{id}/incomingrelationships"
method: GET
path: "/digitaltwins/{id}/incomingrelationships"
tags: ["Twins"]
---

# GET /digitaltwins/{id}/incomingrelationships

`GET /digitaltwins/{id}/incomingrelationships`

Retrieves all incoming relationship for a digital twin.
Status codes:
* 200 OK
* 400 Bad Request
  * InvalidArgument - The digital twin id is invalid.
* 404 Not Found
  * DigitalTwinNotFound - The digital twin was not found.

## Path parameters

- `id` string, required

## Query parameters

- `api-version` string, required

## Response `200`

Success

- IncomingRelationshipCollection — A collection of incoming relationships which relate digital twins together.
  - `value` IncomingRelationship[], required
    - `$relationshipId` string — A user-provided string representing the id of this relationship, unique in the context of the source digital twin, i.e. sourceId + relationshipId is unique in the context of the service.
    - `$sourceId` string — The id of the source digital twin.
    - `$relationshipName` string — The name of the relationship.
    - `$relationshipLink` string — Link to the relationship, to be used for deletion.
  - `nextLink` string — A URI to retrieve the next page of objects.

## Other responses

- `default` — Default response.

---

[API](https://skmtc.net/azure/apis/digitaltwins-digitaltwins.md) · [All operations](https://skmtc.net/azure/apis/digitaltwins-digitaltwins/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/digitaltwins-digitaltwins/versions/8d81dcdaf9a2/schema)