---
title: "List of available locations and available HostNodes"
method: GET
path: "/locations/"
tags: ["Locations"]
deprecated: true
---

# List of available locations and available HostNodes

`GET /locations/`

## Request

- Base URL: `https://cloud-api.voltagepark.com/api/v1`
- URL: `https://cloud-api.voltagepark.com/api/v1/locations/`
- Auth: one of:
  - HTTP bearer
  - API key in header `UI-Authorization`
- TypeScript: <https://skmtc.dev/voltagepark/apis/voltage-park-on-demand-api/docs/locations/get.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- PaginatedResultFullLocationDetails
  - `results` FullLocationDetails[], required
    - `id` string, uuid, required
    - `city` string, required
    - `region` string, required
    - `country` string, required
    - `hostnodes` HostNodeDetails[], required
      - `id` string, uuid, required
      - `location_id` string, uuid, required
      - `available_resources` HardwareResources, required: Catalog total resources model (for when GPU count or other resource count is potentially 0). Used to keep stock of resources on a host
        - `gpus` object, required
        - `vcpu_count` integer, required
        - `ram_gb` integer, required
        - `storage_gb` integer, required
      - `pricing` HostNodePricing, required
        - `per_gpu_hr` object, required
        - `per_vcpu_hr` string, required
        - `per_gb_ram_hr` string, required
        - `per_gb_storage_hr` string, required
      - `available_ports` integer[], required
  - `total_result_count` integer, required
  - `has_previous` boolean, required
  - `has_next` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/voltagepark/apis/voltage-park-on-demand-api.md) - [All operations](https://skmtc.dev/voltagepark/apis/voltage-park-on-demand-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voltagepark/apis/voltage-park-on-demand-api/revisions/11c2e9146826?raw)