ePost Digital Letterbox

Get deleted letters and its remaining days to be permanently deleted.

get/epost/v2/letters/deleted

Request

  • Base URL: https://api.klara.ch
  • URL: https://api.klara.ch/epost/v2/letters/deleted
  • Auth: one of:
    • API key in header X-API-KEY
    • HTTP bearer

Query parameters

limitinteger

Define the limit of the letter list that this API returns.<br />For example, if a user have 20 letters in their inbox, and this <b>limit</b> parameter is 5, and the <b>offset</b> parameter is 0,<br />then this API will return letter list containing the first 5 letters<br />If not set, then default value of 48 is used

offsetinteger

Define which position to start getting letter list.<br />For example, if a user have 20 letters in their inbox, and this <b>offset</b> parameter is 5,<br />then this API will return letter list from the 5th letter.<br />If not set, then default value of 0 is used

sender-participant-idstring

Filter count letters from a specific sender by their participant id. Example: aaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Response

Retrieve deleted letters successfully.

idstring

Id of the letter.

letterTitlestring

This is the letter title.

fileNamestring

This is the name of the reference file of the letter.

senderParticipantIdstring

The participant id of the sender.

senderUserIdstring

The sender user id of the letter.

senderCaseIdstring

The sender case id of the letter.

senderEndToEndIdstring

The sender end to end id of the letter.

documentTypesstring[]

Types of the letter's document.

letterContentReferencestring

This is the reference link that user can use to get to content of the letter.

letterType'CLASSIC_LETTER' | 'SMART_LETTER' | 'SMART_LETTER_ANSWER' | 'SIMPLE_SHORT_MESSAGE' | 'INCAMAIL' | 'SECURESEND'

The letter type.

receivedDateTimestring

The date and time (yyyy-MM-dd'T'HH:mm:ssZ) that the letter was received.

documentMessagestring

The message content of the simple short message

descriptionstring

Free-text description shown alongside the letter in eArchive. Sourced from the description supplied at upload time.

readStatus'READ' | 'UNREAD'

The read status of the document.

remainingDayToDeleteinteger

The remaining days before permanently delete

registeredStatusstring

The current registration status

eLetterRegisteredboolean

Letter is registered or not

Example response

[
  {
    "id": "1",
    "letterTitle": "eVoting questionnaire",
    "fileName": "invoice.pdf",
    "senderParticipantId": "b0f742a3-0a54-401d-bf41-38a3a9628953",
    "senderUserId": "84332810",
    "senderCaseId": "8wq2d8ca",
    "senderEndToEndId": "4ffdec250928157ec24ef24716468b0f25f074e6",
    "documentTypes": [
      "contract",
      "invoice"
    ],
    "letterContentReference": "https://api.klara.ch/epost/v2/letters/1/content",
    "letterType": "CLASSIC_LETTER",
    "receivedDateTime": "2021-09-29T04:21:10.163Z",
    "documentMessage": "Dear Peter \n Your appointment on 28.05.2022 has been cancelled. Please contact us to arrange a new one",
    "description": "Monthly invoice file",
    "readStatus": "READ",
    "remainingDayToDelete": 30,
    "registeredStatus": "PENDING | ACCEPTED | LEGALLY_ACCEPTED"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.