---
title: "Get active rental external IDs"
method: POST
path: "/v2/private/active-rentals"
---

# Get active rental external IDs

`POST /v2/private/active-rentals`

Returns external IDs for all active rentals matching the specified provider, region, and machine type

## Request body

- object
  - `provider` 'voltage-park' | 'nebius' | 'gcore' | 'horizon' | 'digital-ocean' | 'verda' | 'hyperstack' | 'forge' | 'private-cloud' | 'mock', required
  - `region` string, required
  - `machineType` 'bare-metal' | 'virtual-machine' | 'any', required
  - `gracePeriodMs` integer

## Response `200`

Successful response

- object
  - `externalIds` string[], required
  - `transitionExternalIds` string[], required

## Other responses

- `400` — Invalid input data
- `401` — Authorization not provided
- `403` — Insufficient access
- `500` — Internal server error

---

[API](https://skmtc.net/hyperbolic/apis/castle-api.md) · [All operations](https://skmtc.net/hyperbolic/apis/castle-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hyperbolic/castle-api/revisions/fd9320b4b13d/schema)