Get One Level Expansion of ER

This endpoint is used to get one level expansion of entities and relationships based on a entity type. Application user has to provide the ercollectionid as part of header body to fetch entities from specific partition.

URL

https://{{HOST}}/apollo/graph/entities($select=eType:{entityType})?$expand=rType:{relationshipType}($expand=eType:{entityType})&v={version}

Method

GET

Required IMS Scopes

  • apollo_read

Request Header Parameters

Type Value Description
Authorization
required		 Bearer {access_token} Authorization token
Content-Type
required		 application/json Content Type
ercollectionid
required		 {ercollectionid} Partition Key

URL Query Parameter

Name Description Example Type
v
optional		 Service Version /entitytypes/{entitytype}/entities?v=1.1 String
includeSystemData
optional		 Flag to indicate if result should have system data field (default false) /entities($select=eType:{entityType})?$expand=rType:{relationshipType}($expand=eType:{entityType}($expand=rType:{relationshipType}($expand=eType:{entityType})))&includeSystemData=true

URL Path Parameters

Name Description Example Type
entityType
required		 Entity schema type id eType:{entityType} string
relationshipType
required		 Relationship schema type id rType:{relationshipType} string

Example

Request


curl -X GET 
'https://{{HOST}}/apollo/graph/entities($select=eType:BRICK_0_4__Building)?$expand=rType:BRICK_0_4__hasPart_Location_Location($expand=eType:BRICK_0_4__Floor)&v=1.1' 
  -H 'Authorization: Bearer {{access_token}}' 
  -H 'Content-Type: application/json' 
  -H 'ercollectionid: TestER-DVDocs'

Response

{
    "status": {
        "message": "",
        "code": "200"
    },
    "data": [
        {
            "id": "JCI-507-B1",
            "entityType": "BRICK_0_4__Building",
            "entityName": "JCI 507 Michigan Street Milwaukee Building B1",
            "brickEntityType": "BRICK_0_4__Location",
            "brickEntitySubType": "BRICK_0_4__Building",
            "BRICK_0_4__hasPart_Location_Location": [
                {
                    "id": "JCI-507-B1-hasPart-JCI-507-B1-F1",
                    "destinationEntityId": "JCI-507-B1-F1",
                    "relationshipType": "BRICK_0_4__hasPart_Location_Location",
                    "brickRelationshipName": "hasPart",
                    "sourceERCollectionId": "TestER-DVDocs",
                    "relationshipName": "JCI-507-B1 hasPart JCI-507-B1-F1",
                    "brickRelationshipType": "BRICK_0_4__hasPart",
                    "sourceEntityId": "JCI-507-B1",
                    "destinationERCollectionId": "TestER-DVDocs",
                    "BRICK_0_4__Floor": {
                        "id": "JCI-507-B1-F1",
                        "entityType": "BRICK_0_4__Floor",
                        "brickEntityType": "BRICK_0_4__Location",
                        "entityName": "JCI 507 Michigan Street Milwaukee Building B1 Floor F1",
                        "brickEntitySubType": "BRICK_0_4__Floor"
                    }
                }
            ]
        }
    ],
    "paging": {
        "totalCount": 1,
        "continuationToken": null
    }
}

Errors

Error Code Description
Bad Request 400 The request could not be understood by the server due to malformed syntax.
Unauthorized 401 The request can not be processed if token is not valid or expired.
Forbidden 403 The request can not proceed if ercollectionid is not registered or does not have any logs in ACL library.