rentals

Get a list of past rentals

Changed on

Deprecated. Returns every past rental in one response. Use GET /v2/on-demand/rentals/history, which returns them a page at a time.

get/v2/on-demand/rental-history

Request

  • Base URL
    https://api.hyperbolic.ai
  • Auth
    HTTP bearer

Response

Successful response

rentalIdstring required
namestring nullable required
labelstring nullable required
rentalType'virtual-machine' | 'bare-metal' required
region'us-central-1' | 'us-central-2' | 'eu-north-2' | 'eu-west-2' | 'eu-north-4' | 'eu-north-5' | 'us-east-1' | 'us-east-2' | 'ca-east-3' | 'eu-north-6' | 'eu-north-7' | 'eu-north-8' | 'eu-north-9' | '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' | 'us-southeast-3' | 'eu-west-5' | 'jp-east-2' | 'us-east-3' | 'uk-central-3' | 'uk-southeast-3' | 'eu-southwest-3' | 'eu-southwest-3-1' | 'eu-west-3' | 'eu-west-4' | 'private-cloud' required
gpuType'h100' | 'h200' | 'b200' | 'rtx-6000-pro' required
gpuCountinteger required
gpuFormFactor'sxm5' | 'sxm6' | 'pcie' required
connectionType'infiniband' | 'ethernet' required
ethernetVariant'normal' | 'rocev2' nullable required
supportsPortForwardingboolean required
exposedPortsnumber[] required
supportsCustomPortsboolean required
supportsMultipleSshKeysboolean required
supportsSshKeyUpdatesboolean required
supportsAttachedStorageboolean required
monitoringEnabledboolean required
convertToOnDemandOnExpiryboolean nullable required
terminationReasonstring nullable required
createdAtstring date-time required
updatedAtstring date-time nullable required
startedAtstring date-time nullable required
terminatedAtstring date-time required
userIdstring required
orgIdstring nullable required
status'Terminated' | 'Failed' required
totalCostnumber required

Example response

[
  {
    "currentTerm": {
      "effectiveAt": "2025-01-31T12:00:00.000Z"
    },
    "createdAt": "2025-01-31T12:00:00.000Z",
    "updatedAt": "2025-01-31T12:00:00.000Z",
    "startedAt": "2025-01-31T12:00:00.000Z",
    "terminatedAt": "2025-01-31T12:00:00.000Z"
  }
]

Changes

    • warning

      added the new jp-east-2 enum value to the / response property for the response status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property / became nullable for the status

    • info

      response property items/convertToOnDemandOnExpiry list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/createdBy/name list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/createdBy/picture list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/label list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/managedCluster/anyOf[ManagedClusterRef]/label list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/name list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/nodes/items/cpuCount list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/nodes/items/vcpuCount list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/orgId list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/privateCluster/anyOf[PrivateCluster]/gpuModel list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/privateCluster/anyOf[PrivateCluster]/location list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/privateCluster/anyOf[PrivateCluster]/nodes/items/hostname list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/privateCluster/anyOf[PrivateCluster]/nodes/items/publicIp list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/privateCluster/anyOf[PrivateCluster]/sshPort list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/terminationReason list-of-types was narrowed by removing types null from media type application/json of response 200