Expand the relationships of one or more vertices

post/traversals

Performs a breadth first graph search following all the relationships (edges) extending outwards from one or more objects (vertices) in the Network visualization. The initial objects whose relationships are to be traversed are found by executing the given query.

Request Samples

1

Response Samples

1{
2  "counts": {
3    "edges": 2,
4    "vertices": 4
5  },
6  "vertices": [
7    {
8      "id": "10",
9      "type": "claim",
10      "typeLabel": "Claim",
11      "label": "Claim: 0009900136650",
12      "attachmentsCount": 3,
13      "adjacent": 1,
14      "degree": 1
15    },
16    {
17      "id": "73",
18      "type": "address",
19      "typeLabel": "Address",
20      "label": "1203 SAMUEL ADAMS CIR, CONCORD, NC",
21      "attachmentsCount": 1,
22      "adjacent": 3,
23      "degree": 3
24    },
25    {
26      "id": "4",
27      "type": "claim",
28      "typeLabel": "Claim",
29      "label": "Claim: 0009900073608",
30      "attachmentsCount": 2,
31      "adjacent": 1,
32      "degree": 1
33    },
34    {
35      "id": "115",
36      "type": "person",
37      "typeLabel": "Person",
38      "compoundValues": [
39        "Smith 1982-03-14"
40      ],
41      "label": "John Smith",
42      "adjacent": 2001,
43      "degree": 2001
44    }
45  ],
46  "edges": [
47    {
48      "id": "9",
49      "type": "entityRelationship",
50      "label": "regarding",
51      "endpoints": [
52        {
53          "id": "10",
54          "type": "claim"
55        },
56        {
57          "id": "73",
58          "type": "address"
59        }
60      ]
61    },
62    {
63      "id": "5",
64      "type": "resolvedEntityRelationship",
65      "label": "raised by",
66      "compoundValues": [
67        "Smith 1982-03-14"
68      ],
69      "endpoints": [
70        {
71          "id": "4",
72          "type": "claim"
73        },
74        {
75          "id": "115",
76          "type": "person",
77          "compoundValues": [
78            "Smith 1982-03-14"
79          ]
80        }
81      ]
82    }
83  ],
84  "expansionLimit": 2000,
85  "expansionLimitExceeded": [
86    {
87      "type": "person",
88      "id": "115"
89    }
90  ]
91}

Query Parameters

NameTypeRequiredDescription
calculateMetrics
boolean
false

Whether to calculate the degree and adjacent counts for all the vertices. As this calculation is expensive, it can take some time particularly for highly connected vertices. Skipping the calculation is recommended when the counts are not needed or when generating the counts leads to a poor user experience.

Default:
true
edgeExpansionLimit
integer
false

The maximum number of new vertices to be found when traversing edges. If a value greater than 0 is specified and the number of new vertices found by the search exceeds the limit, then the search is cancelled and a message is returned.

Default:
10000
expansionLimit
integer
false

The maximum number of new vertices to be found when searching vertices. If a value greater than 0 is specified and the number of new vertices found by the search exceeds the limit, then the search is cancelled and a message is returned.

Default:
2000
metricsAggregationLimit
integer
false

The aggregation used to exclude highly connected vertices from the metrics calculation is skipped when the number of leaf vertices exceeds this limit. The default value of -1 means the aggregation always runs; a value of 0 means the aggregation never runs.

Default:
-1
metricsLimit
integer
false

The maximum number of new vertices to be found by the search when calculating the metrics. If a value greater than 0 is specified and the number of new vertices found by the search exceeds the limit, then the search is cancelled and a message is returned.

Default:
5000

Request Body

The request to /traversals for performing a breadth first graph search in the Network visualization

NameTypeRequiredDescription
version
integer
false

The representation version (3).

vertexTypes
array [string]
false

The optional list of object type names for restricting the search to particular types. If missing, all types are included in the search.

vertexFilter
filter or oneOf
filterTypeAndfilterTypeBoxfilterTypeDateRangefilterTypeNotfilterTypeOrfilterTypePolygonfilterTypeQueryfilterTypeRadiusfilterTypeRangefilterTypeTermsfilterTypeTypefilterTypeShape
false

The different filter types that can be applied to narrow or drill down into the search results. See specific filter definitions for more details.

edgeTypes
array [string]
false

The optional list of relationship type names for restricting the search to particular types. If missing, all types are included in the search.

edgeFilter
filter or oneOf
filterTypeAndfilterTypeBoxfilterTypeDateRangefilterTypeNotfilterTypeOrfilterTypePolygonfilterTypeQueryfilterTypeRadiusfilterTypeRangefilterTypeTermsfilterTypeTypefilterTypeShape
false

The different filter types that can be applied to narrow or drill down into the search results. See specific filter definitions for more details.

query
query or anyOf
queryTypeAndqueryTypeCompoundqueryTypeObjectqueryTypeOrqueryTypeText
false

The different query types that can be used to search for objects. See specific query definitions for more details.

depth
integer
false

The number of levels the traversal should explore. The minimum (and default) value is 1; the maximum value is 3.

extendedFormat
boolean
false

Defaults to false but if set to true, edges will be returned as well as vertex degree and adjacent counts.

graphObjectIds
array [objectIdentifier]
false

The identifiers for additional entity vertices that should be included in the graph but are not already included in the search criteria.

graphCompoundValues
array [string]
false

The compound values for additional resolved entity vertices that should be included in the graph but are not already included in the search criteria.

Responses

StatusMeaningDescription
200OK

The request succeeded.

Schema
400Bad Request

The request is malformed or contains invalid parameter values; or the search had to be cancelled because the number of new vertices exceeded the expansion limit.

Schema