Skip to content

Get data retention status.

GET
/api/admin/data-retention/status
Code sample: Shell / cURL
curl --request GET \
--url https://auth.example.com/api/admin/data-retention/status \
--header 'Authorization: Bearer <token>'

Returns the tenant data-retention policy snapshot, category statistics, pending deletion summary, and GDPR erasure support status.

Data retention status response.

Media type application/json
object
tenant_id
required
string
policy
required
object
enabled
required
boolean
default_retention_days
required
integer
categories
required
object
key
additional properties
cleanup_schedule
required
string
last_cleanup_run
required
string | null format: date-time
next_cleanup_run
required
string | null format: date-time
key
additional properties
categories
required
Array<object>
object
category
required
string
retention_days
required
integer
total_records
required
integer
records_pending_deletion
required
integer
oldest_record_date
required
string | null format: date-time
next_cleanup_date
required
string | null format: date-time
last_cleanup_date
required
string | null format: date-time
records_deleted_last_30_days
required
integer
hot_query_status
string
execution_status
string
Allowed values: available durable_projection_pending
key
additional properties
summary
required
object
total_records
required
integer
records_pending_deletion
required
integer
records_deleted_last_30_days
required
integer
storage_savings_estimate_mb
required
number
key
additional properties
gdpr_compliance
required
object
right_to_erasure_supported
required
boolean
anonymization_supported
required
boolean
tombstone_retention_days
required
integer
pending_erasure_requests
required
integer
key
additional properties
last_updated
required
string format: date-time
key
additional properties
Example
{
"categories": [
{
"execution_status": "available"
}
]
}

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

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

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

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