---
title: "Get Enterprise Search Inventories"
method: GET
path: "/enterprise-search/inventories"
tags: ["Enterprise Search"]
---

# Get Enterprise Search Inventories

`GET /enterprise-search/inventories`

## Request

- Base URL: `https://am1.portal.api.nasuni.com`
- URL: `https://am1.portal.api.nasuni.com/enterprise-search/inventories`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nasuni/apis/portal-api/docs/enterprise-search/inventories/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

Enterprise search inventories retrieved successfully

- EnterpriseSearchEdgeInventoriesResponseDto
  - `items` EnterpriseSearchSummaryEdgeInventoryDto[]
    - `edge_id` string, uuid, required
    - `edge_name` string, required
    - `edge_description` string, required
    - `edge_serial` string, required
    - `days_until_expiry` integer, nullable: Days until the first volume on this edge expires.
    - `search_inventory_status` 'Not Activated' | 'Preparing for Volume Inventory' | 'Volume Inventory In Progress' | 'Ready to Activate' | 'Volume Inventory Failed' | 'Volume Inventory Expired' | 'Removal Pending' | 'Removed' | 'Unknown', required: Enterprise Search volume-inventory lifecycle status. Owned by Enterprise Search — deliberately not shared with or aliased from AI Activate, since the two features are independently licensed and their lifecycles may diverge. Values are listed in the order they occur in the inventory lifecycle.
    - `volume_count` integer
    - `cloud_provider_count` integer
    - `share_count` integer
    - `file_count` integer, nullable: Sum of the reported per-volume file counts on this edge. Volumes whose count NOC has not reported yet are excluded, so this can undercount until every volume has data; null when no volume has reported a count.
    - `idle_removal_time` string, date-time, nullable

## Other responses

- `401`: Not authenticated
- `403`: Insufficient permissions
- `422`: Invalid input data
- `500`: Internal server error

---

[API](https://skmtc.dev/nasuni/apis/portal-api.md) - [All operations](https://skmtc.dev/nasuni/apis/portal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nasuni/apis/portal-api/revisions/2a505bec6d14?raw)