How do I search and filter assets?

Requires Basic

Quick answer

In the asset overview, just type into the search box — the list filters live by name, serial number, and manufacturer. Use “Filter” to narrow it down further by type, status, and department. Via the API, you pass the same criteria as query parameters to GET /api/v1/assets.

Prerequisites

Required role Any logged-in user

— searching and filtering only requires read access to assets. Programmatically, the read scope is enough.

The Assets module is part of the core product and available on all plans.

Instructions

GUI (web interface)

1. Search. Open Assets and type into the search box. The list updates as you type (with a slight delay). Matches are found by name, serial number, and manufacturer — case doesn’t matter, and partial matches are enough.

   Screenshot pending assets-suchen-01 Asset overview with the search box and the 'Filter' button

   The search box filters the list live; next to it, the 'Filter' button.

2. Set filters. Click “Filter”. The advanced filters open: Type (Hardware, Software, Network, Certificate, License, Peripheral), Status (Active, Inactive, Maintenance, …), and Department. All criteria are combined. “Clear filters” removes them all at once.

   Screenshot pending assets-suchen-02 Expanded advanced filters with dropdowns for Type and Status, and the Department field

   The advanced filters: Type, Status, and Department — combinable with the search.

3. Use the results. Clicking a row opens the detail view. Use the checkboxes to select multiple assets and export or delete them in bulk. At the bottom of the table, you can page through the results and set the page size.

API (curl)

All criteria are query parameters of GET /api/v1/assets (scope read):

Parameter	Effect
search	Partial match on name, serial number, manufacturer (case-insensitive)
asset_type	exact type: hardware, software, network, certificate, license, peripheral
status	exact status: active, inactive, maintenance, retired, disposed
department	exact department name
location	Partial match on location
page, page_size	pagination (default 25, maximum 100 per page)

Search combined with filters

curl -H "Authorization: Bearer inv_dein_token" \
  "https://demo.notory.io/api/v1/assets?search=thinkpad&asset_type=hardware&status=active&page=1&page_size=50"

Response (200 OK, truncated)

{
  "items": [
    {
      "id": "a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55",
      "name": "ThinkPad T14 – Vertrieb",
      "asset_type": "hardware",
      "status": "active",
      "serial_number": "PF-3X9K2L",
      "manufacturer": "Lenovo"
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 50,
  "total_pages": 1
}

The filtered result can also be exported directly — as CSV or JSON (the asset_type and status filters are supported):

Export active hardware as CSV

curl -H "Authorization: Bearer inv_dein_token" \
  "https://demo.notory.io/api/v1/assets/export?fmt=csv&asset_type=hardware&status=active" \
  --output assets.csv

Possible errors: 422 (invalid parameters, e.g. page_size over 100), 401 (missing or invalid token).

What happens behind the scenes?

• Search fields: Full-text search covers name, serial number, and manufacturer (partial match, case-insensitive). Department filters exactly, location by partial match.
• The recycle bin is excluded: Deleted assets (in the recycle bin) do not show up in search, filtering, or export.
• Sorting: By default, the list is sorted by creation date — newest first. In the web interface, you can re-sort by clicking the column headers.
• Pagination: The API returns total, page, page_size, and total_pages — so you can cleanly work through every page.
• Tenant isolation: You only see assets belonging to your tenant.

Related topics

• Status & lifecycle — the status values in detail
• Import & Export — bulk import and full exports
• Recycle bin — finding deleted assets
• API Getting Started — authentication, base URL, error codes