REST API

Direct HTTP access to every Vast.ai operation. Search offers, create instances, manage resources — from any language.

Quick example

# Search for available H100s
curl -s -H "Authorization: Bearer $VAST_API_KEY" \
  "https://cloud.vast.ai/api/v0/bundles/?q=%7B%22gpu_name%22%3A%22H100_SXM%22%7D" \
  | jq '.offers[:3] | .[] | {id, gpu_name, num_gpus, dph_total}'

Key endpoints

Method	Endpoint	Description
GET	/api/v0/bundles/	Search available GPU offers
PUT	/api/v0/asks/{id}/	Create instance from offer
GET	/api/v0/instances/	List your instances
PUT	/api/v0/instances/{id}/	Update instance
DELETE	/api/v0/instances/{id}/	Destroy instance

Authentication

All requests require an API key. Pass it as a Bearer token in the Authorization header or as a query parameter.

# Bearer token (recommended)
curl -H "Authorization: Bearer YOUR_API_KEY" https://cloud.vast.ai/api/v0/instances/

# Query parameter
curl "https://cloud.vast.ai/api/v0/instances/?api_key=YOUR_API_KEY"

Explore the full API

Complete endpoint reference with request/response examples.

API Reference Get API Key