# Retrieve a twin relationship

Endpoint: GET /twins/{twinId}/relationships/{relationshipId}
Version: v3
Security: oauth2

## Path parameters:

  - `twinId` (string, required)
    Id of the twin. SourceId for the relationship.

  - `relationshipId` (string, required)
    Id of the relationship

## Response 200 fields (application/json):

  - `id` (string)
    The unique Id of the relationship entity.

  - `targetId` (string, required)
    The Id of the target twin.
    Example: "Chiller-1"

  - `sourceId` (string, required)
    The Id of the source twin.
    Example: "AHU-1"

  - `name` (string, required)
    The name of the relationship, which defines the type of link from source twin to target twin (e.g. isPartOf, locatedIn, servedBy, etc.. ).
    Example: "isFedBy"

  - `properties` (object)
    Additional properties of the relationship as defined in the DTDL model.
    Example: {"substance":"ChilledWater"}