[[rest-api-traversal-returning-nodes-below-a-certain-depth]]
=== Traversal returning nodes below a certain depth ===

Here, all nodes at a traversal depth below 3 are returned.


.Final Graph
["dot", "Final-Graph-Traversal-returning-nodes-below-a-certain-depth.svg", "neoviz"]
----
  N21 [
    label = "{Node\[21\]|name = \'Sara\'\l}"
  ]
  N22 [
    label = "{Node\[22\]|name = \'Johan\'\l}"
  ]
  N22 -> N23 [
    color = "#2e3436"
    fontcolor = "#2e3436"
    label = "knows\n"
  ]
  N23 [
    label = "{Node\[23\]|name = \'Emil\'\l}"
  ]
  N23 -> N26 [
    color = "#2e3436"
    fontcolor = "#2e3436"
    label = "knows\n"
  ]
  N23 -> N25 [
    color = "#2e3436"
    fontcolor = "#2e3436"
    label = "knows\n"
  ]
  N24 [
    label = "{Node\[24\]|name = \'Root\'\l}"
  ]
  N24 -> N27 [
    color = "#2e3436"
    fontcolor = "#2e3436"
    label = "knows\n"
  ]
  N24 -> N22 [
    color = "#2e3436"
    fontcolor = "#2e3436"
    label = "knows\n"
  ]
  N25 [
    label = "{Node\[25\]|name = \'Tobias\'\l}"
  ]
  N25 -> N21 [
    color = "#4e9a06"
    fontcolor = "#4e9a06"
    label = "loves\n"
  ]
  N26 [
    label = "{Node\[26\]|name = \'Peter\'\l}"
  ]
  N27 [
    label = "{Node\[27\]|name = \'Mattias\'\l}"
  ]
----

_Example request_

* *+POST+*  +http://localhost:7474/db/data/node/24/traverse/node+
* *+Accept:+* +application/json+
* *+Content-Type:+* +application/json+
[source,javascript]
----
{
  "return_filter" : {
    "body" : "position.length()<3;",
    "language" : "javascript"
  },
  "prune_evaluator" : {
    "name" : "none",
    "language" : "builtin"
  }
}
----


_Example response_

* *+200:+* +OK+
* *+Content-Type:+* +application/json+
[source,javascript]
----
[ {
  "outgoing_relationships" : "http://localhost:7474/db/data/node/24/relationships/out",
  "data" : {
    "name" : "Root"
  },
  "traverse" : "http://localhost:7474/db/data/node/24/traverse/{returnType}",
  "all_typed_relationships" : "http://localhost:7474/db/data/node/24/relationships/all/{-list|&|types}",
  "property" : "http://localhost:7474/db/data/node/24/properties/{key}",
  "self" : "http://localhost:7474/db/data/node/24",
  "outgoing_typed_relationships" : "http://localhost:7474/db/data/node/24/relationships/out/{-list|&|types}",
  "properties" : "http://localhost:7474/db/data/node/24/properties",
  "incoming_relationships" : "http://localhost:7474/db/data/node/24/relationships/in",
  "extensions" : {
  },
  "create_relationship" : "http://localhost:7474/db/data/node/24/relationships",
  "paged_traverse" : "http://localhost:7474/db/data/node/24/paged/traverse/{returnType}{?pageSize,leaseTime}",
  "all_relationships" : "http://localhost:7474/db/data/node/24/relationships/all",
  "incoming_typed_relationships" : "http://localhost:7474/db/data/node/24/relationships/in/{-list|&|types}"
}, {
  "outgoing_relationships" : "http://localhost:7474/db/data/node/27/relationships/out",
  "data" : {
    "name" : "Mattias"
  },
  "traverse" : "http://localhost:7474/db/data/node/27/traverse/{returnType}",
  "all_typed_relationships" : "http://localhost:7474/db/data/node/27/relationships/all/{-list|&|types}",
  "property" : "http://localhost:7474/db/data/node/27/properties/{key}",
  "self" : "http://localhost:7474/db/data/node/27",
  "outgoing_typed_relationships" : "http://localhost:7474/db/data/node/27/relationships/out/{-list|&|types}",
  "properties" : "http://localhost:7474/db/data/node/27/properties",
  "incoming_relationships" : "http://localhost:7474/db/data/node/27/relationships/in",
  "extensions" : {
  },
  "create_relationship" : "http://localhost:7474/db/data/node/27/relationships",
  "paged_traverse" : "http://localhost:7474/db/data/node/27/paged/traverse/{returnType}{?pageSize,leaseTime}",
  "all_relationships" : "http://localhost:7474/db/data/node/27/relationships/all",
  "incoming_typed_relationships" : "http://localhost:7474/db/data/node/27/relationships/in/{-list|&|types}"
}, {
  "outgoing_relationships" : "http://localhost:7474/db/data/node/22/relationships/out",
  "data" : {
    "name" : "Johan"
  },
  "traverse" : "http://localhost:7474/db/data/node/22/traverse/{returnType}",
  "all_typed_relationships" : "http://localhost:7474/db/data/node/22/relationships/all/{-list|&|types}",
  "property" : "http://localhost:7474/db/data/node/22/properties/{key}",
  "self" : "http://localhost:7474/db/data/node/22",
  "outgoing_typed_relationships" : "http://localhost:7474/db/data/node/22/relationships/out/{-list|&|types}",
  "properties" : "http://localhost:7474/db/data/node/22/properties",
  "incoming_relationships" : "http://localhost:7474/db/data/node/22/relationships/in",
  "extensions" : {
  },
  "create_relationship" : "http://localhost:7474/db/data/node/22/relationships",
  "paged_traverse" : "http://localhost:7474/db/data/node/22/paged/traverse/{returnType}{?pageSize,leaseTime}",
  "all_relationships" : "http://localhost:7474/db/data/node/22/relationships/all",
  "incoming_typed_relationships" : "http://localhost:7474/db/data/node/22/relationships/in/{-list|&|types}"
}, {
  "outgoing_relationships" : "http://localhost:7474/db/data/node/23/relationships/out",
  "data" : {
    "name" : "Emil"
  },
  "traverse" : "http://localhost:7474/db/data/node/23/traverse/{returnType}",
  "all_typed_relationships" : "http://localhost:7474/db/data/node/23/relationships/all/{-list|&|types}",
  "property" : "http://localhost:7474/db/data/node/23/properties/{key}",
  "self" : "http://localhost:7474/db/data/node/23",
  "outgoing_typed_relationships" : "http://localhost:7474/db/data/node/23/relationships/out/{-list|&|types}",
  "properties" : "http://localhost:7474/db/data/node/23/properties",
  "incoming_relationships" : "http://localhost:7474/db/data/node/23/relationships/in",
  "extensions" : {
  },
  "create_relationship" : "http://localhost:7474/db/data/node/23/relationships",
  "paged_traverse" : "http://localhost:7474/db/data/node/23/paged/traverse/{returnType}{?pageSize,leaseTime}",
  "all_relationships" : "http://localhost:7474/db/data/node/23/relationships/all",
  "incoming_typed_relationships" : "http://localhost:7474/db/data/node/23/relationships/in/{-list|&|types}"
} ]
----


