Get tombstone summary

GET

/api/admin/tombstones/stats

Code sample: Shell / cURL

curl --request GET \
  --url https://auth.example.com/api/admin/tombstones/stats \
  --header 'Authorization: Bearer <token>'

Returns total, active, expired, recent, and reason-grouped tombstone counters.

Authorizations

• adminBearer
• adminSessionCookie

Parameters

Query Parameters

tenant_id

string

Platform-scope tenant filter. Tenant-scope routes infer tenant from admin context.

Responses

200

Tombstone summary for the tenant.

Media type application/json

object

total

required

integer

expired

required

integer

active

required

integer

recentDeletions

required

integer

byReason

required

object

key

additional properties

integer

byTenant

required

object | null

tenantId

string

note

required

string

key

additional properties

Example

{
  "total": 12,
  "expired": 3,
  "active": 9,
  "recentDeletions": 2,
  "byReason": {
    "user_request": 8,
    "admin_action": 4
  },
  "byTenant": {
    "tenant_123": 12
  },
  "tenantId": "tenant_123",
  "note": "Expired tombstones can be cleaned up with POST /api/admin/tombstones/cleanup"
}

400

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

401

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

403

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}