---
title: "Get team deletion status"
method: GET
path: "/team-deletions/{id}"
tags: ["Teams"]
---

# Get team deletion status

`GET /team-deletions/{id}`

Retrieve progress for an asynchronous team deletion request

## Path parameters

- `id` string, required — Unique team deletion operation identifier

## Response `200`

OK

- object — Asynchronous team deletion operation
  - `id` string, required — Unique identifier for the deletion operation
  - `teamId` string, required — Team being deleted
  - `status` 'QUEUED' | 'PROCESSING' | 'BLOCKED' | 'COMPLETED' | 'FAILED', required — Current state of an asynchronous team deletion operation
  - `createdAt` string, date-time, required — Timestamp when deletion was requested
  - `updatedAt` string, date-time, required — Timestamp when deletion progress last changed
  - `completedAt` string, date-time — Timestamp when deletion completed
  - `blocker` object — Structured business condition preventing team deletion
    - `reason` 'ADMIN_TEAM' | 'DEMO_TEAM' | 'EVENTS' | 'ORDERS' | 'EVENTS_AND_ORDERS' | 'BUSINESS_RECORDS' | 'SETUP_IN_USE', required — Stable business reason preventing team deletion
    - `hasEvents` boolean, required — Whether active events prevent deletion
    - `hasOrders` boolean, required — Whether orders prevent deletion
  - `error` string — Safe failure description when manual recovery is needed

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `409` — 409
- `412` — 412
- `422` — 422
- `429` — 429
- `500` — 500
- `501` — 501
- `503` — 503

## Changes

> 42 revisions in range; 2 not diffed, 4 could not be searched.

- **2026-08-05** `be4b4b6a2bb6` — 1 warning
  - added the new `DEMO_TEAM` enum value to the `blocker/reason` response property for the response status `200`
- **2026-08-02** `84f157e4443a` — 1 info
  - added the non-success response with the status `412`
- **2026-08-01** `96d322ba1077` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/session/apis/session-services-api/changes/team-deletions/:id/get.md)

---

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