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

---

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