---
title: "NeighboursInput"
description: "an entity, one kind of connection, and the two dates"
section: concepts
address: /concepts/neighboursinput
contract: 0476e35e6e275db5
---

# NeighboursInput

an entity, one kind of connection, and the two dates

[figure: NeighboursInput is a value at none scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | value |
| scope | none |
| key | none |
| store | none |
| family | harness |



## Fields


| field | type | required | note |
|---|---|---|---|
| `entity` | `id` | yes |  |
| `kind` | [KindOfConnection](/concepts/kindofconnection) | yes |  |
| `role` | `text` | no |  |



## Routes that use it
- [`/v1/ask/neighbours`](/reference/ask/neighbours) takes it as input