# Public Cloud › Storage › Block Storage › Service references API > Part of the OVHcloud developer hub. Index of every page and section: https://developers.eu.ovhcloud.com/llms.txt > The Public Cloud product's sections: https://developers.eu.ovhcloud.com/reference/public-cloud/llms.txt > Everything in one file: https://developers.eu.ovhcloud.com/llms-full.txt > 1 operation of the OVHcloud API. Calls carry `authorization: Bearer $OVH_TOKEN`; the EU host is shown, Canada and the United States answer on api.ca.ovhcloud.com and api.us.ovhcloud.com. Page: https://developers.eu.ovhcloud.com/reference/public-cloud/storage/block-storage/service-references/ OpenAPI v1: https://api.eu.ovhcloud.com/1.0/__schemas/developer-hub-navigation/public-cloud/storage/block-storage/service-references.json?format=openapi3 OpenAPI v2: https://api.eu.ovhcloud.com/v2/__schemas/developer-hub-navigation/public-cloud/storage/block-storage/service-references.json?format=openapi3 ## Operations - `GET /publicCloud/project/{projectId}/reference/storage/block/volumeType` — List block storage volume types ## List block storage volume types `GET /v2/publicCloud/project/{projectId}/reference/storage/block/volumeType` Link: https://developers.eu.ovhcloud.com/reference/public-cloud/storage/block-storage/service-references/#getVolumeTypes **Status:** Stable production version **IAM actions:** `publicCloudProject:apiovh:reference/storage/block/volumeType/get` Returns the volume types with their IOPS, throughput and maximum volume size. The list holds one entry per volume type and region: a volume type sold in several regions appears once per region, with the figures of that region and the region in `location`. The regions already activated on the project and those the project can activate where a volume type is sold are both listed. `location.regionActivated` on each entry tells which regions must be activated on the project before use. `location.availabilityZones` lists the availability zones of the region, for example eu-west-par-a, eu-west-par-b and eu-west-par-c, and is empty for a single-AZ region. Entries are grouped by volume type, then sorted by region name. For IOPS and throughput, `level` is the baseline, `maximum` the upper limit a volume can burst to, and `guaranteed` tells whether the baseline is guaranteed. `maximumSize` is the maximum volume size in GB. ### Parameters | Name | In | Type | Required | Description | | --- | --- | --- | --- | --- | | `X-Pagination-Cursor` | header | string | | Pagination cursor | | `X-Pagination-Size` | header | integer | | Pagination size | | `projectId` | path | string | yes | Project ID | | `region` | query | string | | Optional region filter, case-insensitive. Keeps the entries of this region only. A region that does not exist is rejected. One the project can neither use nor activate returns an empty list. | ### Responses | Status | Type | Description | | --- | --- | --- | | 200 | publicCloud.reference.storage.block.VolumeType[] | successful operation | | Field | Type | Required | Description | | --- | --- | --- | --- | | `iops` | publicCloud.reference.storage.block.VolumeTypePerformance | read-only | Input/output operations per second of a volume of this type in this region | | `iops.guaranteed` | boolean | read-only | Whether the baseline level is guaranteed | | `iops.level` | publicCloud.reference.storage.block.VolumeTypePerformanceValue | read-only | Baseline performance of a volume. May be expressed per GB of volume size, see its unit. | | `iops.level.unit` | publicCloud.reference.storage.block.VolumeTypePerformanceUnitEnum | read-only | Unit of the value. Units ending in `/GB` scale with the volume size. — one of `IOPS`, `IOPS/GB`, `MB/S`, `MB/S/GB` | | `iops.level.value` | number | read-only | Numeric value, expressed in unit | | `iops.maximum` | publicCloud.reference.storage.block.VolumeTypePerformanceValue | read-only | Upper performance limit of a volume | | `iops.maximum.unit` | publicCloud.reference.storage.block.VolumeTypePerformanceUnitEnum | read-only | Unit of the value. Units ending in `/GB` scale with the volume size. — one of `IOPS`, `IOPS/GB`, `MB/S`, `MB/S/GB` | | `iops.maximum.value` | number | read-only | Numeric value, expressed in unit | | `location` | publicCloud.reference.Location | read-only | Region where the volume type is sold to the project, whether that region is already activated on the project (regionActivated), and the availability zones of that region (availabilityZones), empty for a single-AZ region | | `location.availabilityZones` | string[] | read-only | Availability zones of the region, for example eu-west-par-a, eu-west-par-b and eu-west-par-c. Empty for a single-AZ region. | | `location.region` | string | read-only | Region name, for example GRA11 | | `location.regionActivated` | boolean | read-only | Whether the region is already activated on the project. When false, the region must be activated on the project before use. | | `maximumSize` | integer | read-only | Maximum size of a volume of this type in this region in GB | | `name` | publicCloud.blockStorage.VolumeTypeEnum | read-only | Volume type identifier, to use as the volume type when creating a volume — one of `CLASSIC`, `HIGH_SPEED`, `HIGH_SPEED_GEN2` | | `throughput` | publicCloud.reference.storage.block.VolumeTypePerformance | read-only | Throughput of a volume of this type in this region. Null when no throughput figure is published for this region. | | `throughput.guaranteed` | boolean | read-only | Whether the baseline level is guaranteed | | `throughput.level` | publicCloud.reference.storage.block.VolumeTypePerformanceValue | read-only | Baseline performance of a volume. May be expressed per GB of volume size, see its unit. | | `throughput.level.unit` | publicCloud.reference.storage.block.VolumeTypePerformanceUnitEnum | read-only | Unit of the value. Units ending in `/GB` scale with the volume size. — one of `IOPS`, `IOPS/GB`, `MB/S`, `MB/S/GB` | | `throughput.level.value` | number | read-only | Numeric value, expressed in unit | | `throughput.maximum` | publicCloud.reference.storage.block.VolumeTypePerformanceValue | read-only | Upper performance limit of a volume | | `throughput.maximum.unit` | publicCloud.reference.storage.block.VolumeTypePerformanceUnitEnum | read-only | Unit of the value. Units ending in `/GB` scale with the volume size. — one of `IOPS`, `IOPS/GB`, `MB/S`, `MB/S/GB` | | `throughput.maximum.value` | number | read-only | Numeric value, expressed in unit | ```json [ { "iops": { "guaranteed": true, "level": { "unit": "IOPS", "value": 0 }, "maximum": { "unit": "IOPS", "value": 0 } }, "location": { "availabilityZones": [ "string" ], "region": "string", "regionActivated": true }, "maximumSize": 0, "name": "CLASSIC", "throughput": { "guaranteed": true, "level": { "unit": "IOPS", "value": 0 }, "maximum": { "unit": "IOPS", "value": 0 } } } ] ``` ### Example ```bash curl -X GET \ "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/reference/storage/block/volumeType" \ -H "accept: application/json" \ -H "authorization: Bearer $OVH_TOKEN" ``` ```python ''' First, install the latest release of Python wrapper: $ pip install ovh ''' import json import ovh # Instantiate an OVH Client. # You can generate new credentials with full access to your account on # the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*) client = ovh.Client( endpoint='ovh-eu', # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application) application_key='xxxxxxxxxx', # Application Key application_secret='xxxxxxxxxx', # Application Secret consumer_key='xxxxxxxxxx', # Consumer Key ) result = client.get("/v2/publicCloud/project/{projectId}/reference/storage/block/volumeType") # Pretty print print(json.dumps(result, indent=4)) ``` ```php get("/v2/publicCloud/project/{projectId}/reference/storage/block/volumeType"); print_r($result); ?> ```