> For the complete documentation index, see [llms.txt](https://docs.parqex.com/-MUyxAVrX9S4wky8UoX6/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.parqex.com/-MUyxAVrX9S4wky8UoX6/the-basics/entities.md).

# Entities

### Device

A `Device` represents a single ParqEx Access Controller. Each device can have one or more `Door` (depending on the model. see below what a single-door entity looks like). The attributes of a `Device` are as follows:

| Attribute Name                  | Data Type                           | Description                                                               |
| ------------------------------- | ----------------------------------- | ------------------------------------------------------------------------- |
| `id`                            | UUID                                | Unique identifier of the `Device`                                         |
| `number_of_entities_controlled` | Integer                             | *1-100*                                                                   |
| `doors`                         | Object                              | An object array of `Door`s (see below)                                    |
| `last_contact`                  | Timestamp (eg. YYYY-MM-DD HH:MM:SS) | Timestamp of the last time the `Device` reached out to the ParqEx service |
| `active`                        | Boolean                             | **true** if `Device` is enabled/authorized by ParqEx, **false** otherwise |
| `registered`                    | Boolean                             | **true** if `Device` is registered with ParqEx, **false** otherwise       |

### Door

A `Door` represents a single access control point (pedestrian door, garage door, elevator button etc.) opener connected to a ParqEx Controller. A `Door` must belong to a device. The attributes of a device are as follows:

| Attribute Name      | Data Type                           | Description                                                                                                                               |
| ------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                | UUID                                | Unique identifier of the `Door`                                                                                                           |
| `image`             | String                              | *Deprecated*                                                                                                                              |
| `light`             | Boolean                             | *Deprecated*                                                                                                                              |
| `sensor`            | Boolean                             | *Deprecated*                                                                                                                              |
| `last_toggled`      | Timestamp (eg. YYYY-MM-DD HH:MM:SS) | Timestamp of the last time the `Device` reported a `Door` state change                                                                    |
| `name`              | String                              | A name assigned by the user. Every user can set their own unique names.                                                                   |
| `active`            | Boolean                             | **true** if the `Door` has been registered to a `Device`, **false** otherwise                                                             |
| `state`             | Enum                                | Either “OPEN” or “CLOSED”. Represents current state of door.                                                                              |
| `user_relationship` | String                              | “Owner” if the current user is the admin of the `Device`, “Has Access” otherwise (see [Permissions](broken://pages/-MP2Ba1_GDtzgd6emWr6)) |