---
title: "List billing addons and compute instance selections"
method: GET
path: "/v1/projects/{ref}/billing/addons"
tags: ["Billing"]
---

# List billing addons and compute instance selections

`GET /v1/projects/{ref}/billing/addons`

Returns the billing addons that are currently applied, including the active compute instance size, and lists every addon option that can be provisioned with pricing metadata.

## Path parameters

- `ref` string, required

## Response `200`

- ListProjectAddonsResponse
  - `selected_addons` object[], required
    - `type` 'custom_domain' | 'compute_instance' | 'pitr' | 'ipv4' | 'auth_mfa_phone' | 'auth_mfa_web_authn' | 'log_drain' | 'etl_pipeline', required
    - `variant` object, required
      - `id` union, required
        - 'ci_micro' | 'ci_small' | 'ci_medium' | 'ci_large' | 'ci_xlarge' | 'ci_2xlarge' | 'ci_4xlarge' | 'ci_8xlarge' | 'ci_12xlarge' | 'ci_16xlarge' | 'ci_24xlarge' | 'ci_24xlarge_optimized_cpu' | 'ci_24xlarge_optimized_memory' | 'ci_24xlarge_high_memory' | 'ci_48xlarge' | 'ci_48xlarge_optimized_cpu' | 'ci_48xlarge_optimized_memory' | 'ci_48xlarge_high_memory'
        - 'cd_default'
        - 'pitr_7' | 'pitr_14' | 'pitr_28'
        - 'ipv4_default'
        - 'auth_mfa_phone_default'
        - 'auth_mfa_web_authn_default'
        - 'log_drain_default'
        - 'etl_pipeline_default'
      - `name` string, required
      - `price` object, required
        - `description` string, required
        - `type` 'fixed' | 'usage', required
        - `interval` 'monthly' | 'hourly', required
        - `amount` number, required
      - `meta` unknown
  - `available_addons` object[], required
    - `type` 'custom_domain' | 'compute_instance' | 'pitr' | 'ipv4' | 'auth_mfa_phone' | 'auth_mfa_web_authn' | 'log_drain' | 'etl_pipeline', required
    - `name` string, required
    - `variants` object[], required
      - `id` union, required
        - 'ci_micro' | 'ci_small' | 'ci_medium' | 'ci_large' | 'ci_xlarge' | 'ci_2xlarge' | 'ci_4xlarge' | 'ci_8xlarge' | 'ci_12xlarge' | 'ci_16xlarge' | 'ci_24xlarge' | 'ci_24xlarge_optimized_cpu' | 'ci_24xlarge_optimized_memory' | 'ci_24xlarge_high_memory' | 'ci_48xlarge' | 'ci_48xlarge_optimized_cpu' | 'ci_48xlarge_optimized_memory' | 'ci_48xlarge_high_memory'
        - 'cd_default'
        - 'pitr_7' | 'pitr_14' | 'pitr_28'
        - 'ipv4_default'
        - 'auth_mfa_phone_default'
        - 'auth_mfa_web_authn_default'
        - 'log_drain_default'
        - 'etl_pipeline_default'
      - `name` string, required
      - `price` object, required
        - `description` string, required
        - `type` 'fixed' | 'usage', required
        - `interval` 'monthly' | 'hourly', required
        - `amount` number, required
      - `meta` unknown

## Other responses

- `401` — Unauthorized
- `403` — Forbidden action
- `429` — Rate limit exceeded
- `500` — Failed to list project addons

---

[API](https://skmtc.net/supabase/apis/management-api.md) · [All operations](https://skmtc.net/supabase/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/supabase/management-api/versions/a7cb39418064/schema)