Get a deletion certificate
Módulo Platform
GET/deletion-certificates/{id}deletionCertificates.get
The record of an org whose data was deleted (1351, Section 14.7), kept after the org is gone. Read only by the former Owner it was issued to. The PDF itself is downloaded from Atlas. Returns one deletion certificate with its `ETag`. A deletion certificate the caller may not see returns 404.
- Requiere la capacidad org.settings.read.
- Alcances de OAuth: org.
- Estados de error: 400, 401, 404, 429. Los errores son detalles de problema RFC 9457.
Parámetros de ruta y de consulta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | string (uuid) | Sí | Identifier of the deletion certificate. |
| fields | Fields | No | Sparse fieldset: a comma-separated list of top-level fields to return. `id` is always returned.Restricciones: pattern ^[a-z_][a-z0-9_]*(,[a-z_][a-z0-9_]*)*$ |
Respuesta 200: DeletionCertificate
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | string (uuid) | Sí | Identifier of the deletion certificate. |
| created_at | string (date-time) | Sí | When the row was created. |
| updated_at | string (date-time) | Sí | When the row was last updated. |
| deleted_org_id | string (uuid) | Sí | Id the deleted org had. |
| org_name | string | Sí | Name of the org when it was deleted.Restricciones: length 1 to 300 |
| org_slug | string | Sí | Web address of the org when it was deleted.Restricciones: length 1 to 100 |
| basis | "cancellation" | "deletion_request" | Sí | Day 90 of a cancellation, or the end of a deletion request's recovery window. |
| requested_at | string (date-time) | Sí | When the Owner canceled or asked for deletion. |
| due_at | string (date-time) | Sí | When the data became due for deletion. |
| purged_at | string (date-time) | null | Sí | When every row of the org was deleted. |
| tables_purged | integer | null | Sí | Tables rows were deleted from.Restricciones: range 0 to any |
| rows_purged | integer | null | Sí | Rows deleted.Restricciones: range 0 to any |
| storage_objects_deleted | integer | Sí | Stored files deleted.Restricciones: range 0 to any |
| document_sha256 | string | null | Sí | SHA-256 of the certificate PDF.Restricciones: length 1 to 64 |
| issued_at | string (date-time) | null | Sí | When the certificate PDF was stored. |
| delivered_at | string (date-time) | null | Sí | When the certificate was emailed to the former Owner. |
{
"id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
"created_at": "2026-10-08T14:30:00Z",
"updated_at": "2026-10-08T14:30:00Z",
"deleted_org_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
"org_name": "Harbor Lights Productions",
"org_slug": "harbor-lights",
"basis": "cancellation",
"requested_at": "2026-10-08T14:30:00Z",
"due_at": "2026-10-08T14:30:00Z",
"purged_at": "2026-10-08T14:30:00Z",
"tables_purged": 41,
"rows_purged": 1820,
"storage_objects_deleted": 12,
"document_sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
"issued_at": "2026-10-08T14:30:00Z",
"delivered_at": "2026-10-08T14:30:00Z"
}Ejemplos de código
curl -X GET "$XOS_BASE_URL/deletion-certificates/0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f" \
-H "Authorization: Bearer $XOS_API_KEY"const { data, etag } = await xos.deletionCertificates.get("0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f");response = xos.deletion_certificates.get("0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f")xos deletion-certificates get 0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f