Get one InventoryAsset

GET

api

spaces

inventoryassets

{id}

Get one InventoryAsset

curl --request GET \
  --url https://spaces.nexudus.com/api/spaces/inventoryassets/{id} \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/api/spaces/inventoryassets/{id}"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/api/spaces/inventoryassets/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "BusinessId": 123,
  "BusinessName": "<string>",
  "Name": "<string>",
  "Description": "<string>",
  "Sku": "<string>",
  "ImageFileName": "<string>",
  "NewImageUrl": "<string>",
  "ClearImageFile": true,
  "Value": 123,
  "FloorPlanDeskId": 123,
  "FloorPlanDeskName": "<string>",
  "CoworkerFullNames": "<string>",
  "CoworkerIds": "<string>",
  "CoworkerStartDates": "<string>",
  "CoworkerEndDates": "<string>",
  "ResourceId": 123,
  "ResourceName": "<string>",
  "AssignToType": 123,
  "Id": 123,
  "UniqueId": "<string>",
  "CreatedOn": "<string>",
  "UpdatedOn": "<string>",
  "UpdatedBy": "<string>",
  "IsNew": true,
  "SystemId": "<string>"
}

An InventoryAsset represents a physical asset — such as a desk, chair, monitor, printer, or other piece of equipment — that a location can track and optionally assign to customers. Each asset belongs to a single location (BusinessId) and can be assigned to a specific scope via AssignToType:

AssignToType value	Meaning
1 (Location)	Assigned to the location generally, not tied to a specific resource or floor-plan item
2 (Resource)	Linked to a bookable resource (e.g. a specific meeting room) via `ResourceId`
3 (FloorPlanItem)	Linked to a floor-plan desk via `FloorPlanDeskId`

Assets may also be assigned to one or more coworkers. The read-only fields CoworkerIds, CoworkerFullNames, CoworkerStartDates, and CoworkerEndDates reflect current assignments. To manage coworker-level assignments, use the CoworkerInventoryAsset entity instead.

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the InventoryAsset-Read role.

Path Parameters

integer

required

The Id of the InventoryAsset record to retrieve.

Code Examples

curl -X GET \
  "https://spaces.nexudus.com/api/spaces/inventoryassets/87654321" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch(
  'https://spaces.nexudus.com/api/spaces/inventoryassets/87654321',
  {
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const record = await response.json();

import requests

response = requests.get(
    'https://spaces.nexudus.com/api/spaces/inventoryassets/87654321',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN'
    }
)

record = response.json()

Response

200

integer

ID of the business linked to this record.

string

Name of the location this asset belongs to.

string

Display name of the asset (e.g. ‘Standing Desk #3’, ‘HP LaserJet’).

string

Free-text description of the asset.

string

Stock-keeping unit code for the asset.

string

Current file name of the image (read-only; upload via the corresponding URL field).

string

URL of a new file to upload as the image.

boolean

Set to true to remove the current image file.

number

Monetary value of the asset.

integer

ID of the floor plan desk linked to this record.

string

Name of the linked floor-plan desk.

string

Comma-separated full names of coworkers currently assigned to this asset.

string

Comma-separated IDs of coworkers currently assigned to this asset.

string

Comma-separated start dates of each coworker assignment.

string

Comma-separated end dates of each coworker assignment.

integer

ID of the resource linked to this record.

string

Name of the linked bookable resource.

integer

Determines what this asset is assigned to: Location (1), Resource (2), or FloorPlanItem (3). See eInventoryAssetAssignToType enum values: 1 = Location, 2 = Resource, 3 = FloorPlanItem.

integer

Unique record identifier.

string

UUID of the record.

string

Date and time the record was created (ISO 8601).

string

Date and time the record was last updated (ISO 8601).

string

Email of the user who last updated this record.

boolean

Whether the record was recently created.

string

External system identifier.

Example Response

{
  "BusinessId": 0,
  "BusinessName": null,
  "Name": "",
  "Description": null,
  "Sku": null,
  "ImageFileName": null,
  "NewImageUrl": null,
  "ClearImageFile": null,
  "Value": null,
  "FloorPlanDeskId": null,
  "FloorPlanDeskName": null,
  "CoworkerFullNames": null,
  "CoworkerIds": null,
  "CoworkerStartDates": null,
  "CoworkerEndDates": null,
  "ResourceId": null,
  "ResourceName": null,
  "AssignToType": 0,
  "Id": 87654321,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "CreatedOn": "2025-01-10T08:00:00Z",
  "UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "UpdatedBy": "admin@example.com",
  "IsNew": false,
  "SystemId": null,
  "ToStringText": "InventoryAsset Example",
  "LocalizationDetails": null,
  "CustomFields": null
}

Get multiple InventoryAssetsRetrieve multiple InventoryAsset records by their Ids in a single request.

Get one InventoryAsset

curl --request GET \
  --url https://spaces.nexudus.com/api/spaces/inventoryassets/{id} \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/api/spaces/inventoryassets/{id}"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/api/spaces/inventoryassets/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "BusinessId": 123,
  "BusinessName": "<string>",
  "Name": "<string>",
  "Description": "<string>",
  "Sku": "<string>",
  "ImageFileName": "<string>",
  "NewImageUrl": "<string>",
  "ClearImageFile": true,
  "Value": 123,
  "FloorPlanDeskId": 123,
  "FloorPlanDeskName": "<string>",
  "CoworkerFullNames": "<string>",
  "CoworkerIds": "<string>",
  "CoworkerStartDates": "<string>",
  "CoworkerEndDates": "<string>",
  "ResourceId": 123,
  "ResourceName": "<string>",
  "AssignToType": 123,
  "Id": 123,
  "UniqueId": "<string>",
  "CreatedOn": "<string>",
  "UpdatedOn": "<string>",
  "UpdatedBy": "<string>",
  "IsNew": true,
  "SystemId": "<string>"
}

Overview

Apps & Marketplace

Billing

Collaboration

Community

Content

CRM

Security

Spaces

Support

System

Authentication

Path Parameters

Code Examples

Response

200

​Authentication

​Path Parameters

​Code Examples

​Response

​200

Authentication

Path Parameters

Code Examples

Response

200