---
title: "[Public Preview] List Registry Options (Subscription Tiers and Available Regions)"
method: GET
path: "/v2/registries/options"
tags: ["DigitalOcean-public.v2-new_Container Registries"]
---

# [Public Preview] List Registry Options (Subscription Tiers and Available Regions)

`GET /v2/registries/options`

This endpoint serves to provide additional information as to which option values are available when creating a container registry.
There are multiple subscription tiers available for container registry. Each tier allows a different number of image repositories to be created in your registry, and has a different amount of storage and transfer included.
There are multiple regions available for container registry and controls where your data is stored.
To list the available options, send a GET request to `/v2/registries/options`. This is similar to GET `/v2/registry/options` and exists for backward compatibility.

## Response `200`

The response will be a JSON object with a key called `options` which contains a key called `subscription_tiers` listing the available tiers.

- object
  - `options` object
    - `available_regions` string[]
    - `subscription_tiers` object[]
      - `name` string — The name of the subscription tier.
      - `slug` string — The slug identifier of the subscription tier.
      - `included_repositories` integer — The number of repositories included in the subscription tier. `0` indicates that the subscription tier includes unlimited repositories.
      - `included_storage_bytes` integer — The amount of storage included in the subscription tier in bytes.
      - `allow_storage_overage` boolean — A boolean indicating whether the subscription tier supports additional storage above what is included in the base plan at an additional cost per GiB used.
      - `included_bandwidth_bytes` integer — The amount of outbound data transfer included in the subscription tier in bytes.
      - `monthly_price_in_cents` integer — The monthly cost of the subscription tier in cents.
      - `storage_overage_price_in_cents` integer — The price paid in cents per GiB for additional storage beyond what is included in the subscription plan.
      - `eligible` boolean — A boolean indicating whether your account it eligible to use a certain subscription tier.
      - `eligibility_reasons` string[] — If your account is not eligible to use a certain subscription tier, this will include a list of reasons that prevent you from using the tier.

## Other responses

- `401` — Authentication failed due to invalid credentials.
- `429` — The API rate limit has been exceeded.
- `500` — There was a server error.
- `default` — There was an unexpected error.

## Changes

- **2025-10-16** `cb3bf9b21459` — 2 info
  - api tag `DigitalOcean-public.v2-new_Container Registries` added
  - api tag `Container Registries` removed
- **2025-07-18** `f8e8c290636c` — 1 info
  - endpoint added
- **2025-07-17** `5fc9af728e82` — 1 breaking
  - api path removed without deprecation
- **2025-07-17** `f8e8c290636c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/digitalocean/apis/digitalocean-api/changes/v2/registries/options/get.md)

---

[API](https://skmtc.dev/digitalocean/apis/digitalocean-api.md) · [All operations](https://skmtc.dev/digitalocean/apis/digitalocean-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/digitalocean/digitalocean-api/revisions/cb3bf9b21459/schema)