---
title: "[Beta] Gets the latest status of the project's upgrade"
method: GET
path: "/v1/projects/{ref}/upgrade/status"
tags: ["Projects"]
---

# [Beta] Gets the latest status of the project's upgrade

`GET /v1/projects/{ref}/upgrade/status`

## Path parameters

- `ref` string, required

## Query parameters

- `tracking_id` string

## Response `200`

- DatabaseUpgradeStatusResponse
  - `databaseUpgradeStatus` object, nullable, required
    - `initiated_at` string, required
    - `latest_status_at` string, required
    - `target_version` number, required
    - `error` '1_upgraded_instance_launch_failed' | '2_volume_detachchment_from_upgraded_instance_failed' | '3_volume_attachment_to_original_instance_failed' | '4_data_upgrade_initiation_failed' | '5_data_upgrade_completion_failed' | '6_volume_detachchment_from_original_instance_failed' | '7_volume_attachment_to_upgraded_instance_failed' | '8_upgrade_completion_failed' | '9_post_physical_backup_failed'
    - `progress` '0_requested' | '1_started' | '2_launched_upgraded_instance' | '3_detached_volume_from_upgraded_instance' | '4_attached_volume_to_original_instance' | '5_initiated_data_upgrade' | '6_completed_data_upgrade' | '7_detached_volume_from_original_instance' | '8_attached_volume_to_upgraded_instance' | '9_completed_upgrade' | '10_completed_post_physical_backup'
    - `status` number, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden action
- `429` — Rate limit exceeded
- `500` — Failed to retrieve project upgrade status

---

[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)