---
title: "Get-VolumeRange"
slug: "scripting-get-volumerange"
updated: 2025-07-15T19:14:08Z
published: 2025-07-15T19:14:08Z
canonical: "help.agilityblue.com/scripting-get-volumerange"
---

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

# Get-VolumeRange

## Summary

Retrieves an existing volume range.

```powershell
Get-VolumeRange
    -Id
    -IncludeVolume
```

Returns a [volume range](https://apidocs.agilityblue.com/#be5f5383-f972-44cf-b541-17b74e79bb16) object.

## Parameters

| Parameter | Type | Required? | Notes |
| --- | --- | --- | --- |
| Id | Int32 | Yes | The volume range id. |
| IncludeVolume | Switch | No, Defaults to `false` | Adds the parent `Volume` property to the output. |

## Examples

### Get an existing volume range

This example retrieves a specific volume and outputs it as JSON.

```plaintext
Retrieved volume range 6

JSON Results:
{
  "VolumeRangeId": 6,
  "VolumeId": 10,
  "BegNo": "Notify000001",
  "EndNo": "Notify000001",
  "CreatedByFullName": "Max Miller",
  "CreatedById": "d8555513-3db6-451a-9af2-e5d45b57f031",
  "CreatedOn": "2019-09-09T09:01:40.7368803-05:00",
  "CreatedBy": null,
  "LastUpdatedByFullName": "Max Miller",
  "LastUpdatedById": "d8555513-3db6-451a-9af2-e5d45b57f031",
  "LastUpdatedOn": "2019-09-09T09:01:40.7368803-05:00",
  "LastUpdatedBy": null,
  "Volume": {
    "VolumeId": 10,
    "Name": "Notify001",
    "ClientId": 1,
    "Client": null,
    "ClientName": "ABC Inc.",
    "ClientReference": "00001",
    "MatterId": 1,
    "Matter": null,
    "MatterName": "ABC inc. vs. DEF inc.",
    "MatterReference": "00001.0899990",
    "ProjectId": null,
    "Project": null,
    "ProjectDescription": null,
    "TaskId": null,
    "Task": null,
    "TaskName": null,
    "DocCount": 1,
    "PageCount": 0,
    "NativeCount": 0,
    "Notes": null,
    "VolumeRangeBeg": "Notify000001",
    "VolumeRangeEnd": "Notify000001",
    "NumberOfVolumeRanges": 1,
    "VolumeDate": "2019-04-18T00:00:00-05:00",
    "VolumeRanges": [],
    "BatesRanges": [],
    "Fields": [],
    "CreatedByFullName": "Max Miller",
    "CreatedById": "510e109b-6ff5-4442-9670-cd5e3cd82a7a",
    "CreatedOn": "2019-04-18T05:46:53.9803485-05:00",
    "CreatedBy": null,
    "LastUpdatedByFullName": "Max Miller",
    "LastUpdatedById": "510e109b-6ff5-4442-9670-cd5e3cd82a7a",
    "LastUpdatedOn": "2025-03-13T18:10:16.578326+00:00",
    "LastUpdatedBy": null,
    "IsFavorite": false
  }
}
```