---
title: "List Reservations"
method: GET
path: "/v1/accounts/{account_id}/reservations"
tags: ["gateway.openapi_Gateway"]
---

# List Reservations

`GET /v1/accounts/{account_id}/reservations`

## Request

- Base URL: `https://api.fireworks.ai`
- URL: `https://api.fireworks.ai/v1/accounts/{account_id}/reservations`
- Auth: HTTP bearer

Lists reservations for an account.

## Path parameters

- `account_id` string, required

## Query parameters

- `pageSize` integer
- `pageToken` string
- `filter` string
- `orderBy` string
- `readMask` string

## Response `200`

A successful response.

- GatewayListReservationsResponse
  - `reservations` GatewayReservation[]
    - `name` string: The resource name of the reservation, e.g. "accounts/my-account/reservations/abcdef".
    - `displayName` string: Human-readable display name of the reservation. e.g. "My Reservation" Must be fewer than 64 characters long.
    - `description` string: Description of the reservation.
    - `createTime` string, date-time: The creation time of the reservation.
    - `createdBy` string: The email address of the user who created this reservation.
    - `region` 'REGION_UNSPECIFIED' | 'US_IOWA_1' | 'US_VIRGINIA_1' | 'US_VIRGINIA_2' | 'US_ILLINOIS_1' | 'AP_TOKYO_1' | 'US_ARIZONA_1' | 'US_TEXAS_1' | 'US_ILLINOIS_2' | 'EU_FRANKFURT_1' | 'US_TEXAS_2' | 'EU_ICELAND_1' | 'EU_ICELAND_2' | 'US_WASHINGTON_1' | 'US_WASHINGTON_2' | 'US_WASHINGTON_3' | 'AP_TOKYO_2' | 'US_CALIFORNIA_1' | 'US_UTAH_1' | 'US_ARIZONA_3' | 'US_GEORGIA_1' | 'US_GEORGIA_2' | 'US_WASHINGTON_4' | 'US_GEORGIA_3' | 'NA_BRITISHCOLUMBIA_1' | 'US_GEORGIA_4' | 'US_OHIO_1' | 'US_NEWYORK_1' | 'EU_NETHERLANDS_1' | 'US_WASHINGTON_5' | 'US_MINNESOTA_1' | 'US_CALIFORNIA_2' | 'NA_BRITISHCOLUMBIA_2' | 'AP_MALAYSIA_2' | 'US_OREGON_1' | 'NA_BRITISHCOLUMBIA_3' | 'AP_NEWSOUTHWALES_1' | 'AP_TAIWAN_1'
    - `multiRegion` 'MULTI_REGION_UNSPECIFIED' | 'GLOBAL' | 'US' | 'CANADA' | 'EUROPE' | 'APAC'
    - `acceleratorType` 'ACCELERATOR_TYPE_UNSPECIFIED' | 'NVIDIA_A100_80GB' | 'NVIDIA_H100_80GB' | 'AMD_MI300X_192GB' | 'NVIDIA_A10G_24GB' | 'NVIDIA_A100_40GB' | 'NVIDIA_L4_24GB' | 'NVIDIA_H200_141GB' | 'NVIDIA_B200_180GB' | 'AMD_MI325X_256GB' | 'AMD_MI350X_288GB' | 'NVIDIA_B300_288GB' | 'NVIDIA_GB200' | 'NVIDIA_GB300', required
    - `reservedCount` integer, required: The number of accelerators reserved.
    - `startTime` string, date-time: The timestamp at which the reservation starts (inclusive).
    - `endTime` string, date-time: The timestamp at which the reservation ends (exclusive).
    - `updateTime` string, date-time: The update time for the reservation.
    - `state` 'STATE_UNSPECIFIED' | 'ACTIVE' | 'EXPIRED' | 'DELETING' | 'DELETED' | 'UPDATING': The lifecycle state of the reservation. - ACTIVE: The reservation's capacity is available. - EXPIRED: The reservation has ended. - DELETING: The reservation is being deleted. - DELETED: The reservation has been deleted. - UPDATING: The reservation's capacity is being provisioned or updated.
    - `targetedConsumption` boolean: Reserved for future use. Currently has no effect.
  - `nextPageToken` string: A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
  - `totalSize` integer: The total number of reservations.

## Changes

- **2026-11-18** `0afef807f84b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/changes/v1/accounts/:account_id/reservations/get.md)

---

[API](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api.md) - [All operations](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/revisions/0afef807f84b?raw)
