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:

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

Defines the response schema for /*/list

has_morebooleanRequired

Indicates whether more items are available beyond the current page. When false, the current result set is the final one

400

Invalid request or validation error

application/json

401

Authentication is required

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:

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

Defines the response schema for /*/list

has_morebooleanRequired

Indicates whether more items are available beyond the current page. When false, the current result set is the final one

400

Invalid request or validation error

application/json

401

Authentication is required

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:

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

Response containing the unique identifier of the created resource

idinteger · int64Required

Unique identifier for the created resource

400

Invalid request or validation error

application/json

401

Authentication is required

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:

Query parameters

idinteger · int64Required

Responses

200

Inventory item details

application/json

The Inventory master item

idinteger · int64Required

Unique identifier for the master item

Example: 123

inventory_idinteger · int64Optional

Unique identifier for the inventory

Example: 12

device_idstringOptional

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

Example: 123456789012345

labelstringRequired

The inventory item label

Example: GPS tracker FMC130-001

modelstringOptional

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

Example: telfmb125

asset_idinteger · int64Optional

Unique asset identifier for linking

Example: 21

created_atstring · date-timeRequired

Date and time at which the item was created

Example: 2025-06-30T06:46:10Z

400

Invalid request or validation error

application/json

401

Authentication is required

application/json

404

Inventory item not found

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:

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

204

Inventory item successfully updated (No Content)

400

Invalid request or validation error

application/json

401

Authentication is required

application/json

404

Inventory item not found

application/json

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:

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

Defines the response schema for /*/list

has_morebooleanRequired

Indicates whether more items are available beyond the current page. When false, the current result set is the final one

400

Invalid request or validation error

application/json

401

Authentication is required

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:

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

204

Inventory item successfully activated (No Content)

400

Invalid request or validation error

application/json

401

Authentication is required

application/json

404

Inventory item not found

application/json

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:

Body

idinteger · int64Required

Unique identifier for the recourse

Responses

204

Inventory item successfully archived (No Content)

400

Invalid request or validation error

application/json

401

Authentication is required

application/json

404

Inventory item not found

application/json

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:

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

Defines the response schema for /*/list

has_morebooleanRequired

Indicates whether more items are available beyond the current page. When false, the current result set is the final one

400

Invalid request or validation error

application/json

401

Authentication is required

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:

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

Defines the response schema for /*/list

has_morebooleanRequired

Indicates whether more items are available beyond the current page. When false, the current result set is the final one

400

Invalid request or validation error

application/json

401

Authentication is required

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:

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

Response containing the unique identifier of the created resource

idinteger · int64Required

Unique identifier for the created resource

400

Invalid request or validation error

application/json

401

Authentication is required

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:

Query parameters

idinteger · int64Required

Responses

200

Inventory item details

application/json

The Inventory slave item

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

created_atstring · date-timeRequired

Date and time at which the item was created

Example: 2025-06-30T06:46:10Z

400

Invalid request or validation error

application/json

401

Authentication is required

application/json

404

Inventory item not found

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:

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

204

Inventory item successfully updated (No Content)

400

Invalid request or validation error

application/json

401

Authentication is required

application/json

404

Inventory item not found

application/json

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:

Body

idinteger · int64Required

Unique identifier for the recourse

Responses

204

Inventory item successfully deleted (No Content)

400

Invalid request or validation error

application/json

401

Authentication is required

application/json

404

Inventory item not found

application/json

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:

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

204

Inventory items successfully paired (No Content)

400

Invalid request or validation error

application/json

401

Authentication is required

application/json

404

Inventory item not found

application/json

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

PreviousInventory NextAsset

Last updated 7 months ago

Was this helpful?

hashtagMaster items

hashtagMaster item object

hashtagMaster item endpoints

hashtagList master items

hashtagList master items with advanced filtering

hashtagCreate a new master item

hashtagGet master item by ID

hashtagUpdate an existing master item

hashtagList master item models

hashtagActivate a master item

hashtagArchive a master item

hashtagSlave item

hashtagSlave item object

hashtagSlave item endpoints

hashtagList slave items

hashtagList slave items with advanced filtering

hashtagCreate a new slave item

hashtagGet slave item by ID

hashtagUpdate an existing slave item

hashtagDelete a slave item

hashtagPair a slave with a master item

Master items

Master item object

Master item endpoints

List master items

List master items with advanced filtering

Create a new master item

Get master item by ID

Update an existing master item

List master item models

Activate a master item

Archive a master item

Slave item

Slave item object

Slave item endpoints

List slave items

List slave items with advanced filtering

Create a new slave item

Get slave item by ID

Update an existing slave item

Delete a slave item

Pair a slave with a master item