# Queries

{% hint style="warning" %}
**Navixy Repository API is a work in progress.** This documentation is published for preview purposes only and doesn't reflect a stable release. Structure, field names, and behaviors are subject to change.
{% endhint %}

### deviceTypes

Lists device types for an organization.

```graphql
deviceTypes(
    organizationId: ID!
    filter: CatalogItemFilter
    first: Int
    after: String
    last: Int
    before: String
    orderBy: CatalogItemOrder = { field: ORDER, direction: ASC }
  ): DeviceTypeConnection!
```

**Arguments**

| Name             | Type                | Description                                                                                      |
| ---------------- | ------------------- | ------------------------------------------------------------------------------------------------ |
| `organizationId` | `ID!`               | The organization to retrieve device types for.                                                   |
| `filter`         | `CatalogItemFilter` | Filtering options for the returned device types.                                                 |
| `first`          | `Int`               | The first `n` elements from the [paginated list](/docs/navixy-repository-api/pagination.md).     |
| `after`          | `String`            | The elements that come after the specified [cursor](/docs/navixy-repository-api/pagination.md).  |
| `last`           | `Int`               | The last `n` elements from the [paginated list](/docs/navixy-repository-api/pagination.md).      |
| `before`         | `String`            | The elements that come before the specified [cursor](/docs/navixy-repository-api/pagination.md). |
| `orderBy`        | `CatalogItemOrder`  | The ordering options for the returned device types.                                              |

**Input types:**

<details>

<summary>CatalogItemFilter</summary>

Filtering options for catalog items.

| Field           | Type      | Description                                         |
| --------------- | --------- | --------------------------------------------------- |
| `titleContains` | `String`  | Partial match on title (case-insensitive contains). |
| `codes`         | `[Code!]` | Match any of these codes.                           |

</details>

<details>

<summary>CatalogItemOrder</summary>

Ordering options for catalog items.

| Field       | Type                                                                                                                          | Description             |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| `field`     | [CatalogItemOrderField](/docs/navixy-repository-api/core-api-reference/catalogs/catalog-items.md#type-catalogitemorderfield)! | The field to order by.  |
| `direction` | [OrderDirection](/docs/navixy-repository-api/core-api-reference/common.md#type-orderdirection)!                               | The direction to order. |

</details>

**Output types:**

<details>

<summary>DeviceTypeConnection</summary>

A paginated list of DeviceType items.

**Implements:** [Connection](/docs/navixy-repository-api/core-api-reference/common.md#type-connection)

| Field      | Type                                                                                                       | Description                                                |
| ---------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges`    | \[[DeviceTypeEdge](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-devicetypeedge)!]! | A list of edges.                                           |
| `nodes`    | \[[DeviceType](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-devicetype)!]!         | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-repository-api/core-api-reference/common.md#type-pageinfo)!                        | Information about the current page.                        |
| `total`    | [CountInfo](/docs/navixy-repository-api/core-api-reference/common.md#type-countinfo)                       | The total count of items matching the filter.              |

</details>

<details>

<summary>PageInfo (entity)</summary>

Information about the current page in a paginated connection.

| Field             | Type       | Description                                                |
| ----------------- | ---------- | ---------------------------------------------------------- |
| `hasNextPage`     | `Boolean!` | Whether more items exist after the current page.           |
| `hasPreviousPage` | `Boolean!` | Whether more items exist before the current page.          |
| `startCursor`     | `String`   | The cursor pointing to the first item in the current page. |
| `endCursor`       | `String`   | The cursor pointing to the last item in the current page.  |

</details>

***

### deviceStatuses

Lists device statuses for an organization.

```graphql
deviceStatuses(
    organizationId: ID!
    filter: CatalogItemFilter
    first: Int
    after: String
    last: Int
    before: String
    orderBy: CatalogItemOrder = { field: ORDER, direction: ASC }
  ): DeviceStatusConnection!
```

**Arguments**

| Name             | Type                | Description                                                                                      |
| ---------------- | ------------------- | ------------------------------------------------------------------------------------------------ |
| `organizationId` | `ID!`               | The organization to retrieve device statuses for.                                                |
| `filter`         | `CatalogItemFilter` | Filtering options for the returned device statuses.                                              |
| `first`          | `Int`               | The first `n` elements from the [paginated list](/docs/navixy-repository-api/pagination.md).     |
| `after`          | `String`            | The elements that come after the specified [cursor](/docs/navixy-repository-api/pagination.md).  |
| `last`           | `Int`               | The last `n` elements from the [paginated list](/docs/navixy-repository-api/pagination.md).      |
| `before`         | `String`            | The elements that come before the specified [cursor](/docs/navixy-repository-api/pagination.md). |
| `orderBy`        | `CatalogItemOrder`  | The ordering options for the returned device statuses.                                           |

**Input types:**

<details>

<summary>CatalogItemFilter</summary>

Filtering options for catalog items.

| Field           | Type      | Description                                         |
| --------------- | --------- | --------------------------------------------------- |
| `titleContains` | `String`  | Partial match on title (case-insensitive contains). |
| `codes`         | `[Code!]` | Match any of these codes.                           |

</details>

<details>

<summary>CatalogItemOrder</summary>

Ordering options for catalog items.

| Field       | Type                                                                                                                          | Description             |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| `field`     | [CatalogItemOrderField](/docs/navixy-repository-api/core-api-reference/catalogs/catalog-items.md#type-catalogitemorderfield)! | The field to order by.  |
| `direction` | [OrderDirection](/docs/navixy-repository-api/core-api-reference/common.md#type-orderdirection)!                               | The direction to order. |

</details>

**Output types:**

<details>

<summary>DeviceStatusConnection</summary>

A paginated list of DeviceStatus items.

**Implements:** [Connection](/docs/navixy-repository-api/core-api-reference/common.md#type-connection)

| Field      | Type                                                                                                           | Description                                                |
| ---------- | -------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges`    | \[[DeviceStatusEdge](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-devicestatusedge)!]! | A list of edges.                                           |
| `nodes`    | \[[DeviceStatus](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-devicestatus)!]!         | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-repository-api/core-api-reference/common.md#type-pageinfo)!                            | Information about the current page.                        |
| `total`    | [CountInfo](/docs/navixy-repository-api/core-api-reference/common.md#type-countinfo)                           | The total count of items matching the filter.              |

</details>

<details>

<summary>PageInfo (entity)</summary>

Information about the current page in a paginated connection.

| Field             | Type       | Description                                                |
| ----------------- | ---------- | ---------------------------------------------------------- |
| `hasNextPage`     | `Boolean!` | Whether more items exist after the current page.           |
| `hasPreviousPage` | `Boolean!` | Whether more items exist before the current page.          |
| `startCursor`     | `String`   | The cursor pointing to the first item in the current page. |
| `endCursor`       | `String`   | The cursor pointing to the last item in the current page.  |

</details>

***

### deviceModels

Lists device models with optional vendor filter.

```graphql
deviceModels(
    organizationId: ID!
    filter: DeviceModelFilter
    first: Int
    after: String
    last: Int
    before: String
    orderBy: CatalogItemOrder = { field: TITLE, direction: ASC }
  ): DeviceModelConnection!
```

**Arguments**

| Name             | Type                | Description                                                                                      |
| ---------------- | ------------------- | ------------------------------------------------------------------------------------------------ |
| `organizationId` | `ID!`               | The organization to retrieve device models for.                                                  |
| `filter`         | `DeviceModelFilter` | Filtering options for the returned device models.                                                |
| `first`          | `Int`               | The first `n` elements from the [paginated list](/docs/navixy-repository-api/pagination.md).     |
| `after`          | `String`            | The elements that come after the specified [cursor](/docs/navixy-repository-api/pagination.md).  |
| `last`           | `Int`               | The last `n` elements from the [paginated list](/docs/navixy-repository-api/pagination.md).      |
| `before`         | `String`            | The elements that come before the specified [cursor](/docs/navixy-repository-api/pagination.md). |
| `orderBy`        | `CatalogItemOrder`  | The ordering options for the returned device models.                                             |

**Input types:**

<details>

<summary>DeviceModelFilter</summary>

Filtering options for device models.

| Field           | Type     | Description                                         |
| --------------- | -------- | --------------------------------------------------- |
| `vendorIds`     | `[ID!]`  | Filter by vendors (OR within field).                |
| `titleContains` | `String` | Partial match on title (case-insensitive contains). |
| `code`          | `Code`   | Exact code match.                                   |

</details>

<details>

<summary>CatalogItemOrder</summary>

Ordering options for catalog items.

| Field       | Type                                                                                                                          | Description             |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| `field`     | [CatalogItemOrderField](/docs/navixy-repository-api/core-api-reference/catalogs/catalog-items.md#type-catalogitemorderfield)! | The field to order by.  |
| `direction` | [OrderDirection](/docs/navixy-repository-api/core-api-reference/common.md#type-orderdirection)!                               | The direction to order. |

</details>

**Output types:**

<details>

<summary>DeviceModelConnection</summary>

A paginated list of DeviceModel items.

**Implements:** [Connection](/docs/navixy-repository-api/core-api-reference/common.md#type-connection)

| Field      | Type                                                                                                         | Description                                                |
| ---------- | ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------- |
| `edges`    | \[[DeviceModelEdge](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-devicemodeledge)!]! | A list of edges.                                           |
| `nodes`    | \[[DeviceModel](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-devicemodel)!]!         | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-repository-api/core-api-reference/common.md#type-pageinfo)!                          | Information about the current page.                        |
| `total`    | [CountInfo](/docs/navixy-repository-api/core-api-reference/common.md#type-countinfo)                         | The total count of items matching the filter.              |

</details>

<details>

<summary>PageInfo (entity)</summary>

Information about the current page in a paginated connection.

| Field             | Type       | Description                                                |
| ----------------- | ---------- | ---------------------------------------------------------- |
| `hasNextPage`     | `Boolean!` | Whether more items exist after the current page.           |
| `hasPreviousPage` | `Boolean!` | Whether more items exist before the current page.          |
| `startCursor`     | `String`   | The cursor pointing to the first item in the current page. |
| `endCursor`       | `String`   | The cursor pointing to the last item in the current page.  |

</details>

***

### deviceVendors

Lists device vendors for an organization.

```graphql
deviceVendors(
    organizationId: ID!
    filter: CatalogItemFilter
    first: Int
    after: String
    last: Int
    before: String
    orderBy: CatalogItemOrder = { field: ORDER, direction: ASC }
  ): DeviceVendorConnection!
```

**Arguments**

| Name             | Type                | Description                                                                                      |
| ---------------- | ------------------- | ------------------------------------------------------------------------------------------------ |
| `organizationId` | `ID!`               | The organization to retrieve device vendors for.                                                 |
| `filter`         | `CatalogItemFilter` | Filtering options for the returned device vendors.                                               |
| `first`          | `Int`               | The first `n` elements from the [paginated list](/docs/navixy-repository-api/pagination.md).     |
| `after`          | `String`            | The elements that come after the specified [cursor](/docs/navixy-repository-api/pagination.md).  |
| `last`           | `Int`               | The last `n` elements from the [paginated list](/docs/navixy-repository-api/pagination.md).      |
| `before`         | `String`            | The elements that come before the specified [cursor](/docs/navixy-repository-api/pagination.md). |
| `orderBy`        | `CatalogItemOrder`  | The ordering options for the returned device vendors.                                            |

**Input types:**

<details>

<summary>CatalogItemFilter</summary>

Filtering options for catalog items.

| Field           | Type      | Description                                         |
| --------------- | --------- | --------------------------------------------------- |
| `titleContains` | `String`  | Partial match on title (case-insensitive contains). |
| `codes`         | `[Code!]` | Match any of these codes.                           |

</details>

<details>

<summary>CatalogItemOrder</summary>

Ordering options for catalog items.

| Field       | Type                                                                                                                          | Description             |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| `field`     | [CatalogItemOrderField](/docs/navixy-repository-api/core-api-reference/catalogs/catalog-items.md#type-catalogitemorderfield)! | The field to order by.  |
| `direction` | [OrderDirection](/docs/navixy-repository-api/core-api-reference/common.md#type-orderdirection)!                               | The direction to order. |

</details>

**Output types:**

<details>

<summary>DeviceVendorConnection</summary>

A paginated list of DeviceVendor items.

**Implements:** [Connection](/docs/navixy-repository-api/core-api-reference/common.md#type-connection)

| Field      | Type                                                                                                           | Description                                                |
| ---------- | -------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges`    | \[[DeviceVendorEdge](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-devicevendoredge)!]! | A list of edges.                                           |
| `nodes`    | \[[DeviceVendor](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-devicevendor)!]!         | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-repository-api/core-api-reference/common.md#type-pageinfo)!                            | Information about the current page.                        |
| `total`    | [CountInfo](/docs/navixy-repository-api/core-api-reference/common.md#type-countinfo)                           | The total count of items matching the filter.              |

</details>

<details>

<summary>PageInfo (entity)</summary>

Information about the current page in a paginated connection.

| Field             | Type       | Description                                                |
| ----------------- | ---------- | ---------------------------------------------------------- |
| `hasNextPage`     | `Boolean!` | Whether more items exist after the current page.           |
| `hasPreviousPage` | `Boolean!` | Whether more items exist before the current page.          |
| `startCursor`     | `String`   | The cursor pointing to the first item in the current page. |
| `endCursor`       | `String`   | The cursor pointing to the last item in the current page.  |

</details>

***

### deviceRelationTypes

Lists device relation types for an organization.

```graphql
deviceRelationTypes(
    organizationId: ID!
    filter: CatalogItemFilter
    first: Int
    after: String
    last: Int
    before: String
    orderBy: CatalogItemOrder = { field: ORDER, direction: ASC }
  ): DeviceRelationTypeConnection!
```

**Arguments**

| Name             | Type                | Description                                                                                      |
| ---------------- | ------------------- | ------------------------------------------------------------------------------------------------ |
| `organizationId` | `ID!`               | The organization to retrieve device relation types for.                                          |
| `filter`         | `CatalogItemFilter` | Filtering options for the returned device relation types.                                        |
| `first`          | `Int`               | The first `n` elements from the [paginated list](/docs/navixy-repository-api/pagination.md).     |
| `after`          | `String`            | The elements that come after the specified [cursor](/docs/navixy-repository-api/pagination.md).  |
| `last`           | `Int`               | The last `n` elements from the [paginated list](/docs/navixy-repository-api/pagination.md).      |
| `before`         | `String`            | The elements that come before the specified [cursor](/docs/navixy-repository-api/pagination.md). |
| `orderBy`        | `CatalogItemOrder`  | The ordering options for the returned device relation types.                                     |

**Input types:**

<details>

<summary>CatalogItemFilter</summary>

Filtering options for catalog items.

| Field           | Type      | Description                                         |
| --------------- | --------- | --------------------------------------------------- |
| `titleContains` | `String`  | Partial match on title (case-insensitive contains). |
| `codes`         | `[Code!]` | Match any of these codes.                           |

</details>

<details>

<summary>CatalogItemOrder</summary>

Ordering options for catalog items.

| Field       | Type                                                                                                                          | Description             |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| `field`     | [CatalogItemOrderField](/docs/navixy-repository-api/core-api-reference/catalogs/catalog-items.md#type-catalogitemorderfield)! | The field to order by.  |
| `direction` | [OrderDirection](/docs/navixy-repository-api/core-api-reference/common.md#type-orderdirection)!                               | The direction to order. |

</details>

**Output types:**

<details>

<summary>DeviceRelationTypeConnection</summary>

A paginated list of DeviceRelationType items.

**Implements:** [Connection](/docs/navixy-repository-api/core-api-reference/common.md#type-connection)

| Field      | Type                                                                                                                       | Description                                                |
| ---------- | -------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges`    | \[[DeviceRelationTypeEdge](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-devicerelationtypeedge)!]! | A list of edges.                                           |
| `nodes`    | \[[DeviceRelationType](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-devicerelationtype)!]!         | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-repository-api/core-api-reference/common.md#type-pageinfo)!                                        | Information about the current page.                        |
| `total`    | [CountInfo](/docs/navixy-repository-api/core-api-reference/common.md#type-countinfo)                                       | The total count of items matching the filter.              |

</details>

<details>

<summary>PageInfo (entity)</summary>

Information about the current page in a paginated connection.

| Field             | Type       | Description                                                |
| ----------------- | ---------- | ---------------------------------------------------------- |
| `hasNextPage`     | `Boolean!` | Whether more items exist after the current page.           |
| `hasPreviousPage` | `Boolean!` | Whether more items exist before the current page.          |
| `startCursor`     | `String`   | The cursor pointing to the first item in the current page. |
| `endCursor`       | `String`   | The cursor pointing to the last item in the current page.  |

</details>

***

### device

Retrieves a device by its ID.

```graphql
device(id: ID!): Device
```

**Arguments**

| Name | Type  | Description                       |
| ---- | ----- | --------------------------------- |
| `id` | `ID!` | The ID of the device to retrieve. |

**Output types:**

<details>

<summary>Device</summary>

A tracking device such as a GPS tracker, sensor, or beacon.

**Implements:** [Node](/docs/navixy-repository-api/core-api-reference/common.md#type-node), [Titled](/docs/navixy-repository-api/core-api-reference/common.md#type-titled), [Versioned](/docs/navixy-repository-api/core-api-reference/common.md#type-versioned), [InventoryItem](/docs/navixy-repository-api/core-api-reference/devices/inventory.md#type-inventoryitem)

| Field              | Type                                                                                                                                             | Description                                                                                                                                                                                               |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`               | `ID!`                                                                                                                                            | A globally unique identifier. This ID is opaque and should not be parsed by clients.                                                                                                                      |
| `version`          | `Int!`                                                                                                                                           | The version number for optimistic locking. Incremented on each update. Can be provided in update/delete mutations to prevent lost updates. If omitted, the update proceeds without stale-read protection. |
| `title`            | `String!`                                                                                                                                        | The human-readable display name.                                                                                                                                                                          |
| `organization`     | [Organization](/docs/navixy-repository-api/core-api-reference/organizations.md#type-organization)!                                               | The organization that owns this device.                                                                                                                                                                   |
| `type`             | [DeviceType](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-devicetype)!                                                   | The device type classification.                                                                                                                                                                           |
| `model`            | [DeviceModel](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-devicemodel)!                                                 | The specific device model.                                                                                                                                                                                |
| `status`           | [DeviceStatus](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-devicestatus)!                                               | The current operational status.                                                                                                                                                                           |
| `identifiers`      | \[[DeviceIdentifier](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-deviceidentifier)!]!                                   | The hardware identifiers for this device (IMEI, serial number, MAC address, etc.).                                                                                                                        |
| `asset`            | [Asset](/docs/navixy-repository-api/core-api-reference/assets/types.md#type-asset)                                                               | The asset this device is currently linked to.                                                                                                                                                             |
| `inventory`        | [Inventory](/docs/navixy-repository-api/core-api-reference/devices/inventory.md#type-inventory)                                                  | The inventory this device is currently assigned to.                                                                                                                                                       |
| `relationsFrom`    | \[[DeviceRelation](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-devicerelation)!]!                                       | The outgoing relationships from this device to other devices.                                                                                                                                             |
| `relationsTo`      | \[[DeviceRelation](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-devicerelation)!]!                                       | The incoming relationships from other devices to this device.                                                                                                                                             |
| `inventoryHistory` | [DeviceInventoryRelationConnection](/docs/navixy-repository-api/core-api-reference/devices/inventory.md#type-deviceinventoryrelationconnection)! | The history of inventory assignments for this device.                                                                                                                                                     |

</details>

<details>

<summary>Organization (entity)</summary>

An organization in the hierarchy that owns entities and users.

**Implements:** [Node](/docs/navixy-repository-api/core-api-reference/common.md#type-node), [Versioned](/docs/navixy-repository-api/core-api-reference/common.md#type-versioned), [Titled](/docs/navixy-repository-api/core-api-reference/common.md#type-titled)

| Field        | Type                                                                                                                   | Description                                                                                                                                                                                               |
| ------------ | ---------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`         | `ID!`                                                                                                                  | A globally unique identifier. This ID is opaque and should not be parsed by clients.                                                                                                                      |
| `version`    | `Int!`                                                                                                                 | The version number for optimistic locking. Incremented on each update. Can be provided in update/delete mutations to prevent lost updates. If omitted, the update proceeds without stale-read protection. |
| `title`      | `String!`                                                                                                              | The human-readable display name.                                                                                                                                                                          |
| `externalId` | `String`                                                                                                               | An external system identifier for integration purposes.                                                                                                                                                   |
| `isActive`   | `Boolean!`                                                                                                             | Whether this organization is active.                                                                                                                                                                      |
| `features`   | \[[OrganizationFeature](/docs/navixy-repository-api/core-api-reference/organizations.md#type-organizationfeature)!]!   | The feature flags enabled for this organization.                                                                                                                                                          |
| `parent`     | [Organization](/docs/navixy-repository-api/core-api-reference/organizations.md#type-organization)                      | The parent organization in the hierarchy. Null for root organizations.                                                                                                                                    |
| `children`   | [OrganizationConnection](/docs/navixy-repository-api/core-api-reference/organizations.md#type-organizationconnection)! | The child organizations.                                                                                                                                                                                  |
| `members`    | [MemberConnection](/docs/navixy-repository-api/core-api-reference/organizations/members.md#type-memberconnection)!     | The members of this organization.                                                                                                                                                                         |
| `devices`    | [DeviceConnection](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-deviceconnection)!             | The devices owned by this organization.                                                                                                                                                                   |
| `assets`     | [AssetConnection](/docs/navixy-repository-api/core-api-reference/assets/types.md#type-assetconnection)!                | The assets owned by this organization.                                                                                                                                                                    |
| `geoObjects` | [GeoObjectConnection](/docs/navixy-repository-api/core-api-reference/geo-objects/types.md#type-geoobjectconnection)!   | The geographic objects owned by this organization.                                                                                                                                                        |
| `schedules`  | [ScheduleConnection](/docs/navixy-repository-api/core-api-reference/schedules.md#type-scheduleconnection)!             | The schedules owned by this organization.                                                                                                                                                                 |

</details>

***

### devices

Lists devices for an organization.

```graphql
devices(
    organizationId: ID!
    filter: DeviceFilter
    first: Int
    after: String
    last: Int
    before: String
    orderBy: DeviceOrder = { field: TITLE, direction: ASC }
  ): DeviceConnection!
```

**Arguments**

| Name             | Type           | Description                                                                                      |
| ---------------- | -------------- | ------------------------------------------------------------------------------------------------ |
| `organizationId` | `ID!`          | The organization to retrieve devices for.                                                        |
| `filter`         | `DeviceFilter` | Filtering options for the returned devices.                                                      |
| `first`          | `Int`          | The first `n` elements from the [paginated list](/docs/navixy-repository-api/pagination.md).     |
| `after`          | `String`       | The elements that come after the specified [cursor](/docs/navixy-repository-api/pagination.md).  |
| `last`           | `Int`          | The last `n` elements from the [paginated list](/docs/navixy-repository-api/pagination.md).      |
| `before`         | `String`       | The elements that come before the specified [cursor](/docs/navixy-repository-api/pagination.md). |
| `orderBy`        | `DeviceOrder`  | The ordering options for the returned devices.                                                   |

**Input types:**

<details>

<summary>DeviceFilter</summary>

Filtering options for devices.

| Field                | Type     | Description                                                           |
| -------------------- | -------- | --------------------------------------------------------------------- |
| `typeIds`            | `[ID!]`  | Filter by device types (OR within field).                             |
| `modelIds`           | `[ID!]`  | Filter by device models (OR within field).                            |
| `statusIds`          | `[ID!]`  | Filter by statuses (OR within field).                                 |
| `vendorIds`          | `[ID!]`  | Filter by vendors (OR within field).                                  |
| `identifierContains` | `String` | Partial match on device identifier value (case-insensitive contains). |
| `inventoryIds`       | `[ID!]`  | Filter by inventories (OR within field).                              |
| `titleContains`      | `String` | Partial match on title (case-insensitive contains).                   |

</details>

<details>

<summary>DeviceOrder</summary>

Ordering options for devices.

| Field       | Type                                                                                                      | Description             |
| ----------- | --------------------------------------------------------------------------------------------------------- | ----------------------- |
| `field`     | [DeviceOrderField](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-deviceorderfield) | The field to order by.  |
| `direction` | [OrderDirection](/docs/navixy-repository-api/core-api-reference/common.md#type-orderdirection)!           | The direction to order. |

</details>

**Output types:**

<details>

<summary>DeviceConnection</summary>

A paginated list of Device items.

**Implements:** [Connection](/docs/navixy-repository-api/core-api-reference/common.md#type-connection)

| Field      | Type                                                                                               | Description                                                |
| ---------- | -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges`    | \[[DeviceEdge](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-deviceedge)!]! | A list of edges.                                           |
| `nodes`    | \[[Device](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-device)!]!         | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-repository-api/core-api-reference/common.md#type-pageinfo)!                | Information about the current page.                        |
| `total`    | [CountInfo](/docs/navixy-repository-api/core-api-reference/common.md#type-countinfo)               | The total count of items matching the filter.              |

</details>

<details>

<summary>PageInfo (entity)</summary>

Information about the current page in a paginated connection.

| Field             | Type       | Description                                                |
| ----------------- | ---------- | ---------------------------------------------------------- |
| `hasNextPage`     | `Boolean!` | Whether more items exist after the current page.           |
| `hasPreviousPage` | `Boolean!` | Whether more items exist before the current page.          |
| `startCursor`     | `String`   | The cursor pointing to the first item in the current page. |
| `endCursor`       | `String`   | The cursor pointing to the last item in the current page.  |

</details>

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://navixy.com/docs/navixy-repository-api/core-api-reference/devices/queries.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.