Inventory item

Inventory items are individual devices or components that belong to an inventory. Each item represents a physical unit, such as a tracker or accessory, used to manage and operate an organization's equipment.

Master items

Master item object

Master item endpoints

List master items

get
/v0/inventory_item/master/list

Returns all master items available to the organization

Authorizations
OAuth2authorizationCodeRequired

OAuth 2.0 authentication for Europe. Use this for users based in Europe and adjacent regions.

Authorization URL: Token URL: Refresh URL:
Available scopes:
  • : OpenID Connect scope
  • : Basic user profile
  • : User e-mail address
Query parameters
qstringOptional

A search query string

limitinteger · int32 · max: 1000Optional

Maximum number of items to return (default: 100, max: 1000)

offsetinteger · int32Optional

The index of the first item to return (default: 0)

sortstringOptional

Sort expression. Supports one or more fields, optionally prefixed with - to indicate descending order. For example, label,-created_at

Responses
200

List of inventory items

application/json
get
/v0/inventory_item/master/list
GET /repo/v0/inventory_item/master/list HTTP/1.1
Host: api.navixy.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
  "data": [],
  "has_more": true
}

List master items with advanced filtering

post
/v0/inventory_item/master/list

Returns all master items available to the organization with advanced filtering options

Authorizations
OAuth2authorizationCodeRequired

OAuth 2.0 authentication for Europe. Use this for users based in Europe and adjacent regions.

Authorization URL: Token URL: Refresh URL:
Available scopes:
  • : OpenID Connect scope
  • : Basic user profile
  • : User e-mail address
Body
qstringOptional

A search query string

limitinteger · int32 · max: 1000Optional

Maximum number of items to return

Default: 100
offsetinteger · int32Optional

The index of the first item to return

Default: 0
sortstringOptional

Sort expression. Supports one or more fields, optionally prefixed with - to indicate descending order. For example, label,-created_at

Responses
200

List of inventory items

application/json
post
/v0/inventory_item/master/list
POST /repo/v0/inventory_item/master/list HTTP/1.1
Host: api.navixy.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 129

{
  "q": "text",
  "conditions": {
    "type": "gte",
    "field": "created_at",
    "value": "2025-07-12T17:00:00Z"
  },
  "limit": 100,
  "offset": 0,
  "sort": "text"
}
{
  "data": [],
  "has_more": true
}

Create a new master item

post
/v0/inventory_item/master/create

Adds a master item for the organization

Authorizations
OAuth2authorizationCodeRequired

OAuth 2.0 authentication for Europe. Use this for users based in Europe and adjacent regions.

Authorization URL: Token URL: Refresh URL:
Available scopes:
  • : OpenID Connect scope
  • : Basic user profile
  • : User e-mail address
Body

Defines the request schema for /inventory_item/master/create

inventory_idinteger · int64Optional

Unique identifier for the inventory

Example: 12
modelstringOptional

A code of one of the supported models. See inventory_item/master/model/list

Example: telfmb125Pattern: [-a-z0-9_]{1,255}
device_idstringOptional

The server uses a unique identifier assigned to the device to authenticate and distinguish incoming data from different devices

Example: 123456789012345Pattern: ^[0-9a-zA-Z\-]{1,64}$
labelstringRequired

The inventory item label

Example: GPS tracker FMC130-001
asset_idinteger · int64Optional

Unique asset identifier for linking

Example: 21
Responses
200

Inventory item created successfully

application/json
post
/v0/inventory_item/master/create
POST /repo/v0/inventory_item/master/create HTTP/1.1
Host: api.navixy.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 116

{
  "inventory_id": 12,
  "model": "telfmb125",
  "device_id": "123456789012345",
  "label": "GPS tracker FMC130-001",
  "asset_id": 21
}
{
  "id": 123
}

Get master item by ID

get
/v0/inventory_item/master/read

Returns a master item's data by ID

Authorizations
OAuth2authorizationCodeRequired

OAuth 2.0 authentication for Europe. Use this for users based in Europe and adjacent regions.

Authorization URL: Token URL: Refresh URL:
Available scopes:
  • : OpenID Connect scope
  • : Basic user profile
  • : User e-mail address
Query parameters
idinteger · int64Required
Responses
200

Inventory item details

application/json
get
/v0/inventory_item/master/read
GET /repo/v0/inventory_item/master/read?id=1 HTTP/1.1
Host: api.navixy.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
  "id": 123,
  "inventory_id": 12,
  "device_id": "123456789012345",
  "label": "GPS tracker FMC130-001",
  "model": "telfmb125",
  "asset_id": 21,
  "created_at": "2025-06-30T06:46:10Z"
}

Update an existing master item

post
/v0/inventory_item/master/update

Updates the information of an existing master item

Authorizations
OAuth2authorizationCodeRequired

OAuth 2.0 authentication for Europe. Use this for users based in Europe and adjacent regions.

Authorization URL: Token URL: Refresh URL:
Available scopes:
  • : OpenID Connect scope
  • : Basic user profile
  • : User e-mail address
Body

Defines the request schema for /inventory_item/master/update

idinteger · int64Required

Unique identifier for the master item

Example: 123
inventory_idinteger · int64Optional

Unique identifier for the inventory

Example: 12
modelstringOptional

A code of one of the supported models. See inventory_item/master/model/list

Example: telfmb125Pattern: [-a-z0-9_]{1,255}
device_idstringOptional

The server uses a unique identifier assigned to the device to authenticate and distinguish incoming data from different devices

Example: 123456789012345Pattern: ^[0-9a-zA-Z\-]{1,64}$
labelstringRequired

The inventory item label

Example: GPS tracker FMC130-001
asset_idinteger · int64Optional

Unique asset identifier for linking

Example: 21
Responses
post
/v0/inventory_item/master/update
POST /repo/v0/inventory_item/master/update HTTP/1.1
Host: api.navixy.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 125

{
  "id": 123,
  "inventory_id": 12,
  "model": "telfmb125",
  "device_id": "123456789012345",
  "label": "GPS tracker FMC130-001",
  "asset_id": 21
}

No content

List master item models

get
/v0/inventory_item/master/model/list

Returns all master item models with their respective capabilities and specifications

Authorizations
OAuth2authorizationCodeRequired

OAuth 2.0 authentication for Europe. Use this for users based in Europe and adjacent regions.

Authorization URL: Token URL: Refresh URL:
Available scopes:
  • : OpenID Connect scope
  • : Basic user profile
  • : User e-mail address
Query parameters
qstringOptional

A search query string

limitinteger · int32 · max: 1000Optional

Maximum number of items to return (default: 100, max: 1000)

offsetinteger · int32Optional

The index of the first item to return (default: 0)

sortstringOptional

Sort expression. Supports one or more fields, optionally prefixed with - to indicate descending order. For example, vendor,-name

Responses
200

List of master item models

application/json
get
/v0/inventory_item/master/model/list
GET /repo/v0/inventory_item/master/model/list HTTP/1.1
Host: api.navixy.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
  "data": [],
  "has_more": true
}

Activate a master item

post
/v0/inventory_item/master/activate

Activates a created master device using a unique identifier. The device must be preconfigured and may exist either in the organization's inventory or in a dealer's inventory. Upon activation, the device is assigned to the organization

Authorizations
OAuth2authorizationCodeRequired

OAuth 2.0 authentication for Europe. Use this for users based in Europe and adjacent regions.

Authorization URL: Token URL: Refresh URL:
Available scopes:
  • : OpenID Connect scope
  • : Basic user profile
  • : User e-mail address
Body

Defines the request schema for /inventory_item/master/activate

idinteger · int64Required

Unique identifier for the master item

Example: 123
modelstringOptional

A code of one of the supported models. See inventory_item/master/model/list

Example: telfmb125Pattern: [-a-z0-9_]{1,255}
device_idstringOptional

The server uses a unique identifier assigned to the device to authenticate and distinguish incoming data from different devices

Example: 123456789012345Pattern: ^[0-9a-zA-Z\-]{1,64}$
activation_method_idinteger · int32Required

Unique identifier of one of the authentication methods supported by the model. See inventory_item/master/model/list

Responses
post
/v0/inventory_item/master/activate
POST /repo/v0/inventory_item/master/activate HTTP/1.1
Host: api.navixy.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 159

{
  "id": 123,
  "model": "telfmb125",
  "device_id": "123456789012345",
  "activation_method_id": 1,
  "fields": {
    "iridium_modem_imei": "123456789012345",
    "activation_code": "123"
  }
}

No content

Archive a master item

post
/v0/inventory_item/master/archive

Marks an inventory item as deleted without permanently removing it from the system. This soft delete approach allows recovery of inventory item’s data upon request to support

Authorizations
OAuth2authorizationCodeRequired

OAuth 2.0 authentication for Europe. Use this for users based in Europe and adjacent regions.

Authorization URL: Token URL: Refresh URL:
Available scopes:
  • : OpenID Connect scope
  • : Basic user profile
  • : User e-mail address
Body
idinteger · int64Required

Unique identifier for the recourse

Responses
post
/v0/inventory_item/master/archive
POST /repo/v0/inventory_item/master/archive HTTP/1.1
Host: api.navixy.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 8

{
  "id": 1
}

No content

Slave item

Slave item object

Slave item endpoints

List slave items

get
/v0/inventory_item/slave/list

Returns all slave items available to the organization

Authorizations
OAuth2authorizationCodeRequired

OAuth 2.0 authentication for Europe. Use this for users based in Europe and adjacent regions.

Authorization URL: Token URL: Refresh URL:
Available scopes:
  • : OpenID Connect scope
  • : Basic user profile
  • : User e-mail address
Query parameters
qstringOptional

A search query string

limitinteger · int32 · max: 1000Optional

Maximum number of items to return (default: 100, max: 1000)

offsetinteger · int32Optional

The index of the first item to return (default: 0)

sortstringOptional

Sort expression. Supports one or more fields, optionally prefixed with - to indicate descending order. For example, label,-created_at

Responses
200

List of inventory items

application/json
get
/v0/inventory_item/slave/list
GET /repo/v0/inventory_item/slave/list HTTP/1.1
Host: api.navixy.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
  "data": [],
  "has_more": true
}

List slave items with advanced filtering

post
/v0/inventory_item/slave/list

Returns all slave items available to the organization with advanced filtering options

Authorizations
OAuth2authorizationCodeRequired

OAuth 2.0 authentication for Europe. Use this for users based in Europe and adjacent regions.

Authorization URL: Token URL: Refresh URL:
Available scopes:
  • : OpenID Connect scope
  • : Basic user profile
  • : User e-mail address
Body
qstringOptional

A search query string

limitinteger · int32 · max: 1000Optional

Maximum number of items to return

Default: 100
offsetinteger · int32Optional

The index of the first item to return

Default: 0
sortstringOptional

Sort expression. Supports one or more fields, optionally prefixed with - to indicate descending order. For example, label,-created_at

Responses
200

List of inventory items

application/json
post
/v0/inventory_item/slave/list
POST /repo/v0/inventory_item/slave/list HTTP/1.1
Host: api.navixy.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 129

{
  "q": "text",
  "conditions": {
    "type": "gte",
    "field": "created_at",
    "value": "2025-07-12T17:00:00Z"
  },
  "limit": 100,
  "offset": 0,
  "sort": "text"
}
{
  "data": [],
  "has_more": true
}

Create a new slave item

post
/v0/inventory_item/slave/create

Adds a slave item for the organization

Authorizations
OAuth2authorizationCodeRequired

OAuth 2.0 authentication for Europe. Use this for users based in Europe and adjacent regions.

Authorization URL: Token URL: Refresh URL:
Available scopes:
  • : OpenID Connect scope
  • : Basic user profile
  • : User e-mail address
Body

Defines the request schema for /inventory_item/slave/create

inventory_idinteger · int64Optional

Unique identifier for the inventory

Example: 12
labelstringRequired

The inventory item label

Example: Fuel sensor TD-150
asset_idinteger · int64Optional

Unique asset identifier for linking

Example: 21
master_idinteger · int64Optional

Unique identifier for the master item

Example: 123
Responses
200

Inventory item created successfully

application/json
post
/v0/inventory_item/slave/create
POST /repo/v0/inventory_item/slave/create HTTP/1.1
Host: api.navixy.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 78

{
  "inventory_id": 12,
  "label": "Fuel sensor TD-150",
  "asset_id": 21,
  "master_id": 123
}
{
  "id": 123
}

Get slave item by ID

get
/v0/inventory_item/slave/read

Returns a slave item's data by ID

Authorizations
OAuth2authorizationCodeRequired

OAuth 2.0 authentication for Europe. Use this for users based in Europe and adjacent regions.

Authorization URL: Token URL: Refresh URL:
Available scopes:
  • : OpenID Connect scope
  • : Basic user profile
  • : User e-mail address
Query parameters
idinteger · int64Required
Responses
200

Inventory item details

application/json
get
/v0/inventory_item/slave/read
GET /repo/v0/inventory_item/slave/read?id=1 HTTP/1.1
Host: api.navixy.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
  "id": 321,
  "inventory_id": 12,
  "label": "Fuel sensor TD-150",
  "asset_id": 21,
  "master_id": 123,
  "created_at": "2025-06-30T06:46:10Z"
}

Update an existing slave item

post
/v0/inventory_item/slave/update

Updates the information of an existing slave item

Authorizations
OAuth2authorizationCodeRequired

OAuth 2.0 authentication for Europe. Use this for users based in Europe and adjacent regions.

Authorization URL: Token URL: Refresh URL:
Available scopes:
  • : OpenID Connect scope
  • : Basic user profile
  • : User e-mail address
Body

Defines the request schema for /inventory_item/slave/update

idinteger · int64Required

Unique identifier for the slave item

Example: 321
inventory_idinteger · int64Optional

Unique identifier for the inventory

Example: 12
labelstringRequired

The inventory item label

Example: Fuel sensor TD-150
asset_idinteger · int64Optional

Unique asset identifier for linking

Example: 21
master_idinteger · int64Optional

Unique identifier for the master item

Example: 123
Responses
post
/v0/inventory_item/slave/update
POST /repo/v0/inventory_item/slave/update HTTP/1.1
Host: api.navixy.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 87

{
  "id": 321,
  "inventory_id": 12,
  "label": "Fuel sensor TD-150",
  "asset_id": 21,
  "master_id": 123
}

No content

Delete a slave item

post
/v0/inventory_item/slave/delete

Deletes the specified slave item by its ID

Authorizations
OAuth2authorizationCodeRequired

OAuth 2.0 authentication for Europe. Use this for users based in Europe and adjacent regions.

Authorization URL: Token URL: Refresh URL:
Available scopes:
  • : OpenID Connect scope
  • : Basic user profile
  • : User e-mail address
Body
idinteger · int64Required

Unique identifier for the recourse

Responses
post
/v0/inventory_item/slave/delete
POST /repo/v0/inventory_item/slave/delete HTTP/1.1
Host: api.navixy.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 8

{
  "id": 1
}

No content

Pair a slave with a master item

post
/v0/inventory_item/slave/pair

Pairs a slave device with a master device within the organization's inventory system. Used to establish logical associations between devices (e.g., sensors with trackers). Both devices belong to the same organization but may be located in different inventories.

Authorizations
OAuth2authorizationCodeRequired

OAuth 2.0 authentication for Europe. Use this for users based in Europe and adjacent regions.

Authorization URL: Token URL: Refresh URL:
Available scopes:
  • : OpenID Connect scope
  • : Basic user profile
  • : User e-mail address
Body

Defines the request schema for /inventory_item/slave/pair

idinteger · int64Required

Unique identifier for the slave item

Example: 321
master_idinteger · int64Required

Unique identifier for the master item

Example: 123
Responses
post
/v0/inventory_item/slave/pair
POST /repo/v0/inventory_item/slave/pair HTTP/1.1
Host: api.navixy.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "id": 321,
  "master_id": 123
}

No content

Last updated

Was this helpful?