Skip to main content

Inventory

Query available compute resources, their specifications, pricing, and current availability. This endpoint does not require authentication.


List Inventory

List available compute resources, optionally filtered by type or GPU availability.

Endpoint

GET /tha/v2/inventory

Query Parameters

FieldTypeDescription
typestringFilter by resource type: rental, serverless, or storage.
gpubooleanFilter by GPU availability. Set to true to only return GPU resources.

Example Request

curl -X GET "https://api.targon.com/tha/v2/inventory?type=rental&gpu=true"

Response

Returns an array of inventory objects.

Each inventory object:

FieldTypeDescription
namestringResource identifier (e.g. h200-small).
display_namestringHuman-readable name.
descriptionstringDescription of the resource.
typestringResource type (rental, serverless, storage).
gpubooleanWhether this resource includes a GPU.
specobjectHardware specifications.
cost_per_hournumberHourly cost.
availableintegerNumber of units currently available.

The spec object:

FieldTypeDescription
gpu_typestringGPU type (e.g. "H200").
gpu_countintegerNumber of GPUs.
vcpuintegerVirtual CPU cores.
memoryintegerMemory in MB.
storageintegerStorage in MB.

Example Response

[
{
"name": "h200-small",
"display_name": "NVIDIA H200 - Small",
"description": "Single H200 GPU instance",
"type": "rental",
"gpu": true,
"spec": {
"gpu_type": "H200",
"gpu_count": 1,
"vcpu": 12,
"memory": 115000,
"storage": 0
},
"cost_per_hour": 2.49,
"available": 5
}
]

Errors

Status CodeDescription
400 - Bad RequestInvalid query parameter (unrecognized type or invalid gpu value).
500 - Internal Server ErrorServer error.