curl --request GET \
--url https://api.aireserve.com/v1/gpu/offers \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aireserve.com/v1/gpu/offers"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aireserve.com/v1/gpu/offers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"accelerator": "<string>",
"label": "<string>",
"memoryGb": 0,
"manufacturer": "NVIDIA",
"count": 0,
"availability": "NONE",
"fromUsdPerHour": "<string>",
"regions": [
"<string>"
],
"capabilities": {
"start": true,
"stop": true,
"restart": true,
"ssh": true,
"logs": true,
"persistentVolumes": true,
"stopPreservesRootDisk": true
}
}
],
"nextCursor": "<string>"
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}List GPU offers
What AI Reserve can provide right now, one row per accelerator at the requested GPU count, folded across every backing provider: best stock, lowest in-stock running price, regions with stock, and the capabilities at least one in-stock location supports. A capability that is false here (for example persistentVolumes) cannot be requested for that GPU right now, so clients grey the control instead of letting a launch fail. Nothing is reserved and no provider is named. Requires compute read access.
curl --request GET \
--url https://api.aireserve.com/v1/gpu/offers \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aireserve.com/v1/gpu/offers"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aireserve.com/v1/gpu/offers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"accelerator": "<string>",
"label": "<string>",
"memoryGb": 0,
"manufacturer": "NVIDIA",
"count": 0,
"availability": "NONE",
"fromUsdPerHour": "<string>",
"regions": [
"<string>"
],
"capabilities": {
"start": true,
"stop": true,
"restart": true,
"ssh": true,
"logs": true,
"persistentVolumes": true,
"stopPreservesRootDisk": true
}
}
],
"nextCursor": "<string>"
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}Authorizations
Your AI Reserve API key (aireserve_api_…) from the API Keys page in the portal (https://portal.aireserve.com/keys).
Query Parameters
GPUs per instance (default 1). Stock is read per count.
1 <= x <= 16Only stock in this normalized region.
north_america, united_states, canada, europe, asia_pacific, oceania Only this accelerator; default every accelerator.
A40_48GB, A100_80GB, H100_80GB, H100_NVL_94GB, H200_141GB, B200_180GB, B300_288GB, L40_48GB, L40S_48GB, RTX_2000_ADA_16GB, RTX_4000_ADA_20GB, RTX_6000_ADA_48GB, RTX_A5000_24GB, RTX_PRO_4000_24GB, RTX_PRO_4500_32GB, RTX_PRO_6000_96GB, RTX_PRO_6000_MIG_24GB, RTX_PRO_6000_MIG_48GB, MI300X_192GB Root disk the price includes (default 50).
-9007199254740991 <= x <= 9007199254740991Size of a persistent volume the launch would create; persistentVolumes then reflects where one of that size can be hosted and priced.
-9007199254740991 <= x <= 9007199254740991