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/v3/inventory

Query Parameters

Field	Type	Description
type	string	Filter by resource type: vm or bm.
gpu	boolean	Filter by GPU availability. Set to true to only return GPU resources.
region	string	Filter by region UID (lowercase slug, max 32 characters). Applies to region-scoped resources such as bm.

Example Request

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

Bare-metal capacity in a single region:

curl -X GET "https://api.targon.com/tha/v3/inventory?type=bm&region=us-ord-1"

Response

Returns an array of inventory objects.

Each inventory object:

Field	Type	Description
name	string	Resource identifier (e.g. h200-small).
display_name	string	Human-readable name.
description	string	Description of the resource.
type	string	Resource type (vm or bm).
region	object	Region the resource is offered in. Present for bm. See Region object.
gpu	boolean	Whether this resource includes a GPU.
spec	object	Hardware specifications.
cost_per_hour	number	Hourly cost. Region-specific for bm.
available	integer	Number of units currently available (per region for bm).
reserved	object	Org-scoped endpoint only. { "count", "reservations": [{ "uid", "status", "workload_uid", "reservation_end_at" }] }

Region object

Field	Type	Description
uid	string	Region UID (e.g. us-ord-1). Use as region on BM workloads.
display_name	string	Human-readable name.
country	string	ISO country code.
continent	string	Continent.

The spec object:

Field	Type	Description
gpu_type	string	GPU type (e.g. "H200").
gpu_count	integer	Number of GPUs.
vcpu	integer	Virtual CPU cores.
memory	integer	Memory in MB.
storage	integer	Storage in MB.

Example Response

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

Errors

Status Code	Description
400 - Bad Request	Invalid query parameter (unrecognized type, invalid gpu value, or malformed region).
500 - Internal Server Error	Server error.

---

List Regions

List active regions. Bare-metal inventory and BM workloads are scoped to a region. This endpoint does not require authentication.

Endpoint

GET /tha/v3/region

Example Request

curl -X GET https://api.targon.com/tha/v3/region

Response

Returns an array of Region objects.

[
  {
    "uid": "us-ord-1",
    "display_name": "US Central (Chicago)",
    "country": "US",
    "continent": "North America"
  }
]

Errors

Status Code	Description
500 - Internal Server Error	Server error.

---

Org Inventory

GET /tha/v3/orgs/{org_slug}/inventory

Same query parameters and response shape as List Inventory, plus the reserved field showing capacity reserved for your organization. Requires authentication.