Hoppa till innehållet

Menu

Erasures

More ways to use this page

Read an erasure

GET/v1/erasures/{id}

TypeScript account.erasures.get(erasureId)

Python account.erasures.get(erasure_id)

Key ak_… an account key

The erasure and, once it is done, its outcome. A done erasure can be read for 30 days.

Parameters

  • idin pathstring (uuid)required

    The erasure id.

Responses

200A request to erase one person's data from the account.

  • erasureIdstring (uuid)required
  • status"pending" | "done"required

    pending until Sendora has erased the person, done after.

  • createdAtstring (date-time)required
  • completedAtstring (date-time) or nullrequired

    When the erasure was done; null while pending.

  • pseudonymstring or nullrequired

    What now stands where the address was written in the message log; null while pending.

  • messagesinteger or nullrequired

    Sent messages to the address whose content was deleted; null while pending.

  • receivedMessagesinteger or nullrequired

    Received messages from, naming or to the address whose content was deleted; null while pending.

Example

{
  "erasureId": "6f1d2c3b-4a5e-4f60-8b7a-9c8d7e6f5a41",
  "status": "done",
  "createdAt": "2026-10-04T12:00:00.000Z",
  "completedAt": "2026-10-04T12:00:08.000Z",
  "pseudonym": "erased:3f7a9c1e5b2d8f4a6c0e9b7d5f3a1c8e6b4d2f0a9c7e5b3d1f8a6c4e2b0d9f7a",
  "messages": 3,
  "receivedMessages": 1
}

Errors

Every error answers error, the code, and message, a sentence for a person. A code that adds fields is shown in full below the table.

CodeStatusMeaning
unauthorized401The key is missing, malformed or revoked.
wrong_token_kind403The key is of the other kind: a server key (sk_) where an account key (ak_) is needed, or the reverse. The message names the kind the operation takes.
not_found404No such erasure of this account.