Skip to main content
POST
/
organizations
/
{organization_name}
/
availability
/
sce-gpu-availability
Get GPU Availability
curl --request POST \
  --url https://api.salad.com/api/public/organizations/{organization_name}/availability/sce-gpu-availability \
  --header 'Content-Type: application/json' \
  --header 'Salad-Api-Key: <api-key>' \
  --data '
{
  "gpu_classes": [
    "550e8400-e29b-41d4-a716-446655440000",
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  ],
  "cpu": 4,
  "memory": 8192,
  "storage_amount": 1000000000,
  "country_codes": [
    "US",
    "CA"
  ]
}
'
{
  "available_gpu_batch": 2,
  "available_gpu_low": 1,
  "available_gpu_medium": 1,
  "available_gpu_high": 0,
  "on_call_gpu": 1
}
Last Updated: October 19, 2025

Authorizations

​
Salad-Api-Key
string
header
required

Path Parameters

​
organization_name
string
required

Your organization name. This identifies the billing context for the API operation and represents a security boundary for SaladCloud resources. The organization must be created before using the API, and you must be a member of the organization. The organization name.

Required string length: 2 - 63
Pattern: ^[a-z][a-z0-9-]{0,61}[a-z0-9]$
Example:

"acme-corp"

Body

application/json

Represents a request to check GPU availability

​
gpu_classes
string<uuid>[]
required

A list of available GPU class names

Minimum array length: 1
Example:
[
  "550e8400-e29b-41d4-a716-446655440000",
  "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
]
​
cpu
integer<int32> | null

The number of available CPU cores

Example:

4

​
memory
integer<int64> | null

The amount of available memory in MB

Example:

8192

​
storage_amount
integer<int64> | null

The amount of available storage in bytes

Example:

1000000000

​
country_codes
enum<string>[]

A list of country codes where the resources are available

ISO 3166-1 alpha-2 country codes

Available options:
af,
al,
dz,
as,
ad,
ao,
ai,
aq,
ag,
ar,
am,
aw,
au,
at,
az,
bs,
bh,
bd,
bb,
by,
be,
bz,
bj,
bm,
bt,
bo,
bq,
ba,
bw,
bv,
br,
io,
bn,
bg,
bf,
bi,
cv,
kh,
cm,
ca,
ky,
cf,
td,
cl,
cn,
cx,
cc,
co,
km,
cd,
cg,
ck,
cr,
hr,
cu,
cw,
cy,
cz,
ci,
dk,
dj,
dm,
do,
ec,
eg,
sv,
gq,
er,
ee,
sz,
et,
fk,
fo,
fj,
fi,
fr,
gf,
pf,
tf,
ga,
gm,
ge,
de,
gh,
gi,
gr,
gl,
gd,
gp,
gu,
gt,
gg,
gn,
gw,
gy,
ht,
hm,
va,
hn,
hk,
hu,
is,
in,
id,
ir,
iq,
ie,
im,
il,
it,
jm,
jp,
je,
jo,
kz,
ke,
ki,
kp,
kr,
kw,
kg,
la,
lv,
lb,
ls,
lr,
ly,
li,
lt,
lu,
mo,
mg,
mw,
my,
mv,
ml,
mt,
mh,
mq,
mr,
mu,
yt,
mx,
fm,
md,
mc,
mn,
me,
ms,
ma,
mz,
mm,
na,
nr,
np,
nl,
nc,
nz,
ni,
ne,
ng,
nu,
nf,
mp,
no,
om,
pk,
pw,
ps,
pa,
pg,
py,
pe,
ph,
pn,
pl,
pt,
pr,
qa,
mk,
ro,
ru,
rw,
re,
bl,
sh,
kn,
lc,
mf,
pm,
vc,
ws,
sm,
st,
sa,
sn,
rs,
sc,
sl,
sg,
sx,
sk,
si,
sb,
so,
za,
gs,
ss,
es,
lk,
sd,
sr,
sj,
se,
ch,
sy,
tw,
tj,
tz,
th,
tl,
tg,
tk,
to,
tt,
tn,
tr,
tm,
tc,
tv,
ug,
ua,
ae,
gb,
um,
us,
uy,
uz,
vu,
ve,
vn,
vg,
vi,
wf,
eh,
ye,
zm,
zw,
ax
Example:
["US", "CA"]

Response

Successfully retrieved GPU availability

​
available_gpu_batch
integer<int32>

The number of available GPU batches

Example:

2

​
available_gpu_low
integer<int32>

The number of available low-end GPUs

Example:

1

​
available_gpu_medium
integer<int32>

The number of available medium-end GPUs

Example:

1

​
available_gpu_high
integer<int32>

The number of available high-end GPUs

Example:

0

​
on_call_gpu
integer<int32>

The number of on-call GPUs available

Example:

1