---
title: "Get Team Provisioning Status"
method: GET
path: "/v1/users/{user_id}/provisioning-status"
tags: ["v1", "Users"]
---

# Get Team Provisioning Status

`GET /v1/users/{user_id}/provisioning-status`

Get real-time provisioning status for a user's team.

This endpoint is polled by the frontend to show accurate progress during team setup.
Returns 404 if no provisioning is in progress (team already provisioned).

## Response `200`

Successful Response

- ProvisioningStatus — Overall provisioning status for a team.
  - `overall_status` 'pending' | 'in_progress' | 'completed' | 'failed' — Status of an individual provisioning step.
  - `steps` ProvisioningSteps — All provisioning steps for a new team.
    - `team` ProvisioningStep — Details about a single provisioning step.
      - `status` 'pending' | 'in_progress' | 'completed' | 'failed' — Status of an individual provisioning step.
      - `started_at` string, date-time, nullable
      - `completed_at` string, date-time, nullable
      - `error` string, nullable — Error message if step failed
    - `cube` ProvisioningStep — Details about a single provisioning step.
      - `status` 'pending' | 'in_progress' | 'completed' | 'failed' — Status of an individual provisioning step.
      - `started_at` string, date-time, nullable
      - `completed_at` string, date-time, nullable
      - `error` string, nullable — Error message if step failed
    - `ducklake` ProvisioningStep — Details about a single provisioning step.
      - `status` 'pending' | 'in_progress' | 'completed' | 'failed' — Status of an individual provisioning step.
      - `started_at` string, date-time, nullable
      - `completed_at` string, date-time, nullable
      - `error` string, nullable — Error message if step failed
    - `fi_gcs` ProvisioningStep — Details about a single provisioning step.
      - `status` 'pending' | 'in_progress' | 'completed' | 'failed' — Status of an individual provisioning step.
      - `started_at` string, date-time, nullable
      - `completed_at` string, date-time, nullable
      - `error` string, nullable — Error message if step failed
    - `api_key` ProvisioningStep — Details about a single provisioning step.
      - `status` 'pending' | 'in_progress' | 'completed' | 'failed' — Status of an individual provisioning step.
      - `started_at` string, date-time, nullable
      - `completed_at` string, date-time, nullable
      - `error` string, nullable — Error message if step failed
  - `started_at` string, date-time, nullable
  - `completed_at` string, date-time, nullable
  - `error` string, nullable — Overall error message if provisioning failed

## Other responses

- `404` — Provisioning status not found

---

[API](https://skmtc.dev/definite/apis/defapi.md) · [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definite/defapi/revisions/3943d8deb3be/schema)
