Find instances

Find instances that match specific resource requirements

POST

/auth/v1/seed/catalog/find

curl --request POST \
  --url /auth/v1/seed/catalog/find \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"cloud":"aws","region":"us-east-1","gpu":"A100","gpu_count":4,"cpus":"32+","memory":"128+","max_cost":20}'

Body parameters

cloud

string

Cloud provider. One of `aws`, `azure`, `gcp`. If omitted, searches all providers.

region

string

Target region. If omitted, searches all regions.

cpus

string

CPU requirement. Use an exact value like `"4"` or a minimum like `"4+"`.

memory

string

Memory requirement in GB (e.g., `"16"` or `"16+"`).

gpu

string

GPU type (e.g., `A100`, `H100`, `L4`).

gpu_count

integer

Number of GPUs required.

spot

boolean

If `true`, only return instances with spot pricing available.

max_cost

number

Maximum hourly cost in USD. Only instances at or below this price are returned.

Previous → List catalog

Next Estimate cost →