> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/daytonaio/daytona/llms.txt
> Use this file to discover all available pages before exploring further.

# Get volume

> Retrieve details of a specific volume by name

Get detailed information about a specific volume by its name.

## Path parameters

<ParamField path="name" type="string" required>
  The name of the volume to retrieve
</ParamField>

## Response

<ResponseField name="id" type="string">
  Unique identifier for the volume
</ResponseField>

<ResponseField name="name" type="string">
  Volume name
</ResponseField>

<ResponseField name="size" type="integer">
  Volume size in GB
</ResponseField>

<ResponseField name="state" type="string">
  Current state: `creating`, `ready`, `deleting`, `deleted`, `error`
</ResponseField>

<ResponseField name="organizationId" type="string">
  ID of the organization that owns the volume
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp of volume creation
</ResponseField>

<ResponseField name="deletedAt" type="string">
  ISO 8601 timestamp of volume deletion (only present if deleted)
</ResponseField>

## Example request

```bash theme={null}
curl https://api.daytona.io/volumes/by-name/my-data-volume \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Example response

```json theme={null}
{
  "id": "vol_abc123xyz",
  "name": "my-data-volume",
  "size": 50,
  "state": "ready",
  "organizationId": "org_123",
  "createdAt": "2024-01-15T10:30:00Z"
}
```

## Error responses

<ResponseField name="404">
  Volume not found with the specified name
</ResponseField>

```json theme={null}
{
  "statusCode": 404,
  "message": "Volume not found",
  "error": "Not Found"
}
```