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

# Get Reservation

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

## Request

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

Gets a reservation by name.

## Path parameters

- `account_id` string, required
- `reservation_id` string, required

## Query parameters

- `readMask` string

## Response `200`

A successful response.

- 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.

## 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/:reservation_id/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)
