---
title: "Runs rental supply inventory capture"
method: POST
path: "/v2/private/rental-utilization"
---

# Runs rental supply inventory capture

`POST /v2/private/rental-utilization`

Captures rental availability metrics from all providers and stores snapshots in the database for utilization analysis

## Request body

- object

## Response `200`

Successful response

- object
  - `success` boolean, required
  - `snapshots` object[], required
    - `poolType` 'public' | 'reserved', required
    - `machineType` 'virtual-machine' | 'bare-metal', required
    - `connectionType` 'infiniband' | 'ethernet', required
    - `gpuType` 'h100' | 'h200' | 'b200', required
    - `gpuCountPerNode` number, required
    - `gpuFormFactor` 'sxm5' | 'sxm6' | 'pcie', required
    - `region` union, required
      - 'us-central-1' | 'us-central-2' | 'eu-north-2' | 'eu-west-2' | 'eu-north-4' | 'eu-north-5' | 'us-east-1' | 'us-east-2' | 'eu-north-6' | 'eu-north-7' | 'eu-north-8' | 'ca-west-1' | 'ca-east-1' | 'us-central-3' | 'us-southeast-1' | 'me-central-1' | 'ca-east-2' | 'eu-west-1' | 'us-southeast-2' | 'jp-east-1' | 'mock-region'
      - 'us-central-1' | 'uk-central-3' | 'uk-southeast-3' | 'eu-southwest-3' | 'eu-southwest-3-1' | 'eu-west-3' | 'eu-west-4'
    - `availableNodes` number, required
    - `availableGpus` number, required
    - `enabled` boolean, required
    - `costPerHourCents` number, required
    - `providerCostPerHourCents` number
    - `metadata` object
    - `provider` string, required
  - `supplyAlerts` object, required
    - `alerts` object[], required
      - `region` string, required
      - `availableGpus` number, required
      - `idleSince` string, required
    - `thresholdGpus` number, required
    - `idleHours` number, 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)