Skip to main content
GET
/
api
/
spaces
/
inventoryassets
{
  "Records": [
    {}
  ],
  "CurrentPage": 123,
  "CurrentPageSize": 123,
  "CurrentOrderField": "<string>",
  "CurrentSortDirection": 123,
  "FirstItem": 123,
  "LastItem": 123,
  "TotalItems": 123,
  "TotalPages": 123,
  "HasNextPage": true,
  "HasPreviousPage": true
}
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 valueMeaning
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-List role.

Enums

ValueName
1Location
2Resource
3FloorPlanItem

Query Parameters

Pagination & Sorting

page
integer
default:"1"
The page number to retrieve.
size
integer
default:"25"
The number of records per page.
orderBy
string
The property name to sort results by (e.g. Name, CreatedOn).
dir
integer
Sort direction. 1 for ascending, -1 for descending.

Filters

InventoryAsset_Business
integer
Filter by Business Id.
InventoryAsset_Business_Name
string
Filter by name of the location this asset belongs to.
InventoryAsset_Name
string
Filter by display name of the asset (e.g. ‘Standing Desk #3’, ‘HP LaserJet’).
InventoryAsset_Description
string
Filter by free-text description of the asset.
InventoryAsset_Sku
string
Filter by stock-keeping unit code for the asset.
InventoryAsset_ImageFileName
string
Filter by Image File Name.
InventoryAsset_NewImageUrl
string
Filter by New Image Url.
InventoryAsset_ClearImage
boolean
Filter by Clear Image File.
InventoryAsset_Value
number
Filter by monetary value of the asset.
InventoryAsset_FloorPlanDesk
integer
Filter by Floor Plan Desk Id.
InventoryAsset_FloorPlanDesk_Name
string
Filter by name of the linked floor-plan desk.
InventoryAsset_CoworkerFullNames
string
Filter by comma-separated full names of coworkers currently assigned to this asset.
InventoryAsset_CoworkerIds
string
Filter by comma-separated IDs of coworkers currently assigned to this asset.
InventoryAsset_CoworkerStartDates
string
Filter by comma-separated start dates of each coworker assignment.
InventoryAsset_CoworkerEndDates
string
Filter by comma-separated end dates of each coworker assignment.
InventoryAsset_Resource
integer
Filter by Resource Id.
InventoryAsset_Resource_Name
string
Filter by name of the linked bookable resource.
InventoryAsset_AssignToType
integer
Filter by determines what this asset is assigned to: Location (1), Resource (2), or FloorPlanItem (3).

Range Filters

from_InventoryAsset_Value
number
Filter by monetary value of the asset greater than or equal to this value.
to_InventoryAsset_Value
number
Filter by monetary value of the asset less than or equal to this value.
from_InventoryAsset_CreatedOn
string
Filter records created on or after this date. Format: YYYY-MM-DDTHH:mm.
to_InventoryAsset_CreatedOn
string
Filter records created on or before this date. Format: YYYY-MM-DDTHH:mm.
from_InventoryAsset_UpdatedOn
string
Filter records updated on or after this date. Format: YYYY-MM-DDTHH:mm.
to_InventoryAsset_UpdatedOn
string
Filter records updated on or before this date. Format: YYYY-MM-DDTHH:mm.

Code Examples

Simple listing

curl -X GET \
  "https://spaces.nexudus.com/api/spaces/inventoryassets?page=1&size=15&orderBy=Name&dir=1" \
  -H "Authorization: Bearer YOUR_TOKEN"

Filtering by Name

curl -X GET \
  "https://spaces.nexudus.com/api/spaces/inventoryassets?InventoryAsset_Name=example-value&orderBy=Name&dir=1" \
  -H "Authorization: Bearer YOUR_TOKEN"

Range filters

curl -X GET \
  "https://spaces.nexudus.com/api/spaces/inventoryassets?from_InventoryAsset_UpdatedOn=2025-01-01T00:00&to_InventoryAsset_UpdatedOn=2025-12-31T23:59&orderBy=UpdatedOn&dir=-1" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response

200

Records
InventoryAsset[]
The list of InventoryAsset records matching the query. See the Get one InventoryAsset endpoint for the full list of properties returned for each record.
Partial records — The listing endpoint returns a summary representation of each InventoryAsset. The following fields are not included in the Records[] response: AssignToType.To get all fields, fetch the full record using the Get one InventoryAsset endpoint.Important for updates: When updating a record via PUT, always retrieve the full record with a GET request first, apply your changes to that complete data, and then send the updated record. Do not use data from a listing response as the base for a PUT request, as missing fields may be unintentionally cleared.
CurrentPage
integer
Current page number.
CurrentPageSize
integer
Number of records per page.
CurrentOrderField
string
The field used for sorting.
CurrentSortDirection
integer
The sort direction (1 = ascending, -1 = descending).
FirstItem
integer
Index of the first item on the current page.
LastItem
integer
Index of the last item on the current page.
TotalItems
integer
Total number of matching records across all pages.
TotalPages
integer
Total number of pages.
HasNextPage
boolean
Whether there is a next page of results.
HasPreviousPage
boolean
Whether there is a previous page of results.
Example Response
{
  "Records": [
    {
      "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
    }
  ],
  "CurrentPageSize": 15,
  "CurrentPage": 1,
  "CurrentOrderField": "Name",
  "CurrentSortDirection": 1,
  "FirstItem": 1,
  "HasNextPage": false,
  "HasPreviousPage": false,
  "LastItem": 1,
  "PageNumber": 1,
  "PageSize": 15,
  "TotalItems": 1,
  "TotalPages": 1
}