---
title: "List grouped instance-SKU availability"
method: GET
path: "/preview/v2/availability"
tags: ["Instance SKUs"]
---

# List grouped instance-SKU availability

`GET /preview/v2/availability`

> ⚠️ This endpoint is in [public preview](/preview/roadmap).

Aggregate availability across instance SKUs that match `requirements`, grouped by the given property keys. Each group exposes a summed `total` schedule plus a per-SKU breakdown.

## Query parameters

- `requirements` string
- `group_by` SfcApiName[]

## Response `200`

Grouped availability schedules.

- SfcApiListAvailabilityResponse
  - `object` 'list', required
  - `data` SfcApiAvailabilityGroup[], required
    - `group` SfcApiInstanceSkuProperty[], required — Values of the `group_by` keys that define this group, in the same order as the request's `group_by`. Empty when no `group_by` was passed (single-aggregate case). Properties are projected with the same public-key/value rules as `GET /v2/instance_skus`.
      - `key` SfcApiInstanceSkuPropertyKey, required — A property key describing something about an instance SKU (e.g. `accelerator`).
        - `name` string, required
        - `display_name` string, required — Human-readable display name.
        - `description` string, required
        - `documentation_link` string, nullable — Link to a spec sheet or further documentation.
        - `stable_at` integer, required — Unix timestamp.
        - `deprecated_at` integer — Unix timestamp.
        - `deprecation_info` string, nullable — Migration guidance shown when the key is deprecated.
      - `value` SfcApiInstanceSkuEnumerationValue, required — One allowed value for an enumeration-typed property key.
        - `name` string, required
        - `display_name` string, required — Human-readable display name.
        - `description` string, required
        - `documentation_link` string, nullable
        - `stable_at` integer, required — Unix timestamp.
        - `deprecated_at` integer — Unix timestamp.
        - `deprecation_info` string, nullable — Migration guidance shown when the value is deprecated.
      - `type` 'enumeration', required
    - `allocation_schedule` SfcApiAllocationSchedule, required
      - `total` SfcApiScheduleEntry[], required — Node count over time, as a list of `[start_at, end_at)` time ranges. Example: 5 nodes from t=0 to t=3600 is `[{"start_at": 0, "end_at": 3600, "node_count": 5}]`. `start_at` and `end_at` must be 60-second aligned, `node_count` must be non-negative. On non-final entries, `end_at` may be omitted (inferred from the next entry's `start_at`); gaps fill with `node_count: 0`.
        - `start_at` integer, required — Unix timestamp.
        - `end_at` integer — Unix timestamp.
        - `node_count` integer, required
      - `by_instance_sku` object, required — Allocation schedule keyed by instance SKU. Only includes current and future schedule.

## Other responses

- `401` — Unauthorized.
- `422` — Validation failed.
- `500` — Internal server error.

---

[API](https://skmtc.net/sfcompute/apis/san-francisco-compute-documentation.md) · [All operations](https://skmtc.net/sfcompute/apis/san-francisco-compute-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sfcompute/san-francisco-compute-documentation/revisions/93dd7661e9bb/schema)