GET all Relationships

This endpoint is used to get all relationships from ER API. Application user has to provide the ercollectionid, continuationToken and PageSize as part of header body.

URL

https://{{HOST}}/apollo/er/relationships?v={version}

Method

GET

Required IMS Scopes

  • apollo_read

Versions Supported

1.0 (Default)
1.1

URL Query Parameters

Name Description Example Type
v
optional		 Service Version /relationships?v=1.0 String
includeSystemData
optional		 Flag to include system data (default false) /relationships?includeSystemData=true Boolean

Request Header Parameters

Type Value Description
Authorization
required		 Bearer {access_token} IMS access token (User should have apollo_read scope)
ercollectionid
required		 {ercollectionid} ER Collection id
continuationToken
optional		 {continuationToken} Token for pagination, not required for first page but required for subsequent page
PageSize
optional		 {PageSize} Page size

Example

Request


curl -X GET 
  'https://{{HOST}}/apollo/er/relationships?v=1.1' 
  -H 'Authorization: Bearer {{access_token}}' 
  -H 'Content-Type: application/json' 
  -H 'ercollectionid: TestER-DVDocs' 
  -H 'PageSize: 100'

Response

{
    "status": {
        "message": "",
        "code": "200"
    },
    "data": [
        {
            "id": "JCI-507-B1-hasPart-JCI-507-B1-F1",
            "relationshipName": "JCI-507-B1 hasPart JCI-507-B1-F1",
            "relationshipType": "BRICK_0_4__hasPart_Location_Location",
            "sourceEntityId": "JCI-507-B1",
            "destinationEntityId": "JCI-507-B1-F1",
            "sourceERCollectionId": "TestER-DVDocs",
            "destinationERCollectionId": "TestER-DVDocs",
            "brickRelationshipName": "hasPart",
            "brickRelationshipType": "BRICK_0_4__hasPart",
            "isActive": true
        },
        {
            "id": "JCI-507-B1-F1-hasPart-JCI-507-B1-F1-ETeam1",
            "relationshipName": "JCI-507-B1-F1 hasPart JCI-507-B1-F1-ETeam1",
            "relationshipType": "BRICK_0_4__hasPart_Location_Location",
            "sourceEntityId": "JCI-507-B1-F1",
            "destinationEntityId": "JCI-507-B1-F1-ETeam1",
            "sourceERCollectionId": "TestER-DVDocs",
            "destinationERCollectionId": "TestER-DVDocs",
            "brickRelationshipName": "hasPart",
            "brickRelationshipType": "BRICK_0_4__hasPart",
            "isActive": true
        },
        {
            "id": "JCI-507-B1-F1-isPartOf-JCI-507-B1",
            "relationshipName": "JCI-507-B1-F1 isPartOf JCI-507-B1",
            "relationshipType": "BRICK_0_4__isPartOf_Location_Location",
            "sourceEntityId": "JCI-507-B1-F1",
            "destinationEntityId": "JCI-507-B1",
            "sourceERCollectionId": "TestER-DVDocs",
            "destinationERCollectionId": "TestER-DVDocs",
            "brickRelationshipName": "",
            "brickRelationshipType": "BRICK_0_4__isPartOf",
            "isActive": true
        },
        {
            "id": "JCI-507-B1-F1-ETeam1-isPartOf-JCI-507-B1-F1",
            "relationshipName": "JCI-507-B1-F1-ETeam1 isPartOf JCI-507-B1-F1",
            "relationshipType": "BRICK_0_4__isPartOf_Location_Location",
            "sourceEntityId": "JCI-507-B1-F1-ETeam1",
            "destinationEntityId": "JCI-507-B1-F1",
            "sourceERCollectionId": "TestER-DVDocs",
            "destinationERCollectionId": "TestER-DVDocs",
            "brickRelationshipName": "",
            "brickRelationshipType": "BRICK_0_4__isPartOf",
            "isActive": true
        },
        {
            "id": "JCI-507-B1-F1-ETeam1-contains-JCI-507-Dev-1",
            "relationshipName": "JCI-507-B1-F1-ETeam1 contains JCI-507-Dev-1",
            "relationshipType": "BRICK_0_4__contains_Location_Device",
            "sourceEntityId": "JCI-507-B1-F1-ETeam1",
            "destinationEntityId": "JCI-507-Dev-1",
            "sourceERCollectionId": "TestER-DVDocs",
            "destinationERCollectionId": "TestER-DVDocs",
            "brickRelationshipName": "isSameAs",
            "brickRelationshipType": "BRICK_0_4__contains_Location_Device",
            "isActive": true
        },
        {
            "id": "JCI-507-B1-F1-contains-JCI-507-Dev-1",
            "relationshipName": "JCI-507-B1-F1 contains JCI-507-Dev-1",
            "relationshipType": "BRICK_0_4__contains_Location_Device",
            "sourceEntityId": "JCI-507-B1-F1",
            "destinationEntityId": "JCI-507-Dev-1",
            "sourceERCollectionId": "TestER-DVDocs",
            "destinationERCollectionId": "TestER-DVDocs",
            "brickRelationshipName": "isSameAs",
            "brickRelationshipType": "BRICK_0_4__contains_Location_Device",
            "isActive": true
        },
        {
            "id": "JCI-507-B1-contains-JCI-507-Dev-1",
            "relationshipName": "JCI-507-B1 contains JCI-507-Dev-1",
            "relationshipType": "BRICK_0_4__contains_Location_Device",
            "sourceEntityId": "JCI-507-B1",
            "destinationEntityId": "JCI-507-Dev-1",
            "sourceERCollectionId": "TestER-DVDocs",
            "destinationERCollectionId": "TestER-DVDocs",
            "brickRelationshipName": "isSameAs",
            "brickRelationshipType": "BRICK_0_4__contains_Location_Device",
            "isActive": true
        },
        {
            "id": "JCI-507-Dev-1-isLocatedIn-JCI-507-B1-F1-ETeam1",
            "relationshipName": "JCI-507-Dev-1 isLocatedIn JCI-507-B1-F1-ETeam1",
            "relationshipType": "BRICK_0_4__isLocatedIn_Device_Location",
            "sourceEntityId": "JCI-507-Dev-1",
            "destinationEntityId": "JCI-507-B1-F1-ETeam1",
            "sourceERCollectionId": "TestER-DVDocs",
            "destinationERCollectionId": "TestER-DVDocs",
            "brickRelationshipName": "isSameAs",
            "brickRelationshipType": "BRICK_0_4__isLocatedIn_Device_Location",
            "isActive": true
        },
        {
            "id": "JCI-507-Dev-1-isLocatedIn-JCI-507-B1-F1",
            "relationshipName": "JCI-507-Dev-1 isLocatedIn JCI-507-B1-F1",
            "relationshipType": "BRICK_0_4__isLocatedIn_Device_Location",
            "sourceEntityId": "JCI-507-Dev-1",
            "destinationEntityId": "JCI-507-B1-F1",
            "sourceERCollectionId": "TestER-DVDocs",
            "destinationERCollectionId": "TestER-DVDocs",
            "brickRelationshipName": "isSameAs",
            "brickRelationshipType": "BRICK_0_4__isLocatedIn_Device_Location",
            "isActive": true
        },
        {
            "id": "JCI-507-Dev-1-isLocatedIn-JCI-507-B1",
            "relationshipName": "JCI-507-Dev-1 isLocatedIn JCI-507-B1",
            "relationshipType": "BRICK_0_4__isLocatedIn_Device_Location",
            "sourceEntityId": "JCI-507-Dev-1",
            "destinationEntityId": "JCI-507-B1",
            "sourceERCollectionId": "TestER-DVDocs",
            "destinationERCollectionId": "TestER-DVDocs",
            "brickRelationshipName": "isSameAs",
            "brickRelationshipType": "BRICK_0_4__isLocatedIn_Device_Location",
            "isActive": true
        }
    ],
    "paging": {
        "totalCount": 10,
        "continuationToken": null
    }
}

Errors

Error Description
400 Bad Request – The request could not be understood by the server due to malformed syntax.
403 The request can not proceed if ercollectionid is not registered or does not have any logs in ACL library.