---
title: "Get Ai Activate Volumes"
method: GET
path: "/ai_activate/volumes"
tags: ["AI Activate"]
---

# Get Ai Activate Volumes

`GET /ai_activate/volumes`

## Request

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

Get every volume on the account with its AI Activate indexing state and eligibility.

## Response `200`

AI Activate volumes retrieved successfully

- AiActivateVolumesResponseDto
  - `items` AiActivateVolumeDto[]
    - `volume_guid` string, required
    - `volume_name` string, required
    - `provider` string, required
    - `volume_provider` string, nullable: Cloud provider backing the source volume. May be null on NOC deployments that predate the field.
    - `region` string, nullable: Execution region used for indexing. Null when the volume is not indexed.
    - `volume_region` string, nullable: Storage region of the volume. May be null when NOC has no volume metadata.
    - `status` 'Not Activated' | 'Preparing for Volume Inventory' | 'Volume Inventory In Progress' | 'Ready to Activate' | 'Activation In Progress' | 'Active' | 'Paused' | 'Volume Inventory Failed' | 'Activation Failed' | 'Volume Inventory Expired' | 'Removal Pending' | 'Removed' | 'Unknown', required
    - `file_count` integer, nullable
    - `volume_size` string, nullable: Human-readable volume size string e.g. '10.5 TB'.
    - `nds_capable` boolean, required: Whether NOC considers the volume eligible for AI Activate.
    - `nds_disqualifications` string[]: Reasons the volume is not eligible. Empty when nds_capable is true.
    - `removal_deadline_at` string, date-time, nullable: Instant after which a requested removal stops being reversible. Null when no removal is pending for the volume, and on NOC deployments that predate the field.

## Other responses

- `401`: Not authenticated
- `403`: Insufficient permissions
- `408`: Request timeout
- `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)