HYhyperbolic
rentals

List past rentals

Changed on

Past rentals, most recently terminated first, one page at a time. Pass the response's nextCursor as cursor to read the next page.

get/v2/on-demand/rentals/history

Request

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

Query parameters

cursorstring nullable
limitinteger
gpuType'h100' | 'h200' | 'b200' | 'rtx-6000-pro'
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'
termType'on-demand' | 'reserved' | 'private-cloud'
includePrivateCloudboolean

Include private-cloud rentals. Ignored when termType is set.

rentalType'virtual-machine' | 'bare-metal'

Response

Successful response

nextCursorstring nullable required
totalCountinteger nullable required

Example response

{
  "items": [
    {
      "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

  • 194666d30bfcRevision changes
    • warning

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

    • info

      added the new enum value jp-east-2 to the query request parameter region

  • 6d718ca26d2bRevision changes
    • 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

    • breaking

      the response property became nullable for the status

    • info

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

    • info

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

    • info

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

    • info

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

    • info

      response property items/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/items/name list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/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/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/items/orgId list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/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/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/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/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/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/items/terminationReason list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

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