Record check

Endpoints

• POSTCheck a delivery record by its evidence code/v1/public/verify

The PublicVerification object

One of three answers: found: false; found: true, ready: false (ask again in a few seconds); or the record.

• objectstringrequired

  Always public_verification.

  One of public_verification
• foundbooleanrequired

  Whether a delivery record has this evidence ID. A mistyped, malformed or unknown code all get the same answer: found: false and nothing more.

• readyboolean

  False while the record's latest event is still being sealed: ask again in a few seconds. Present only when found is true.

• evidence_idstring

  The evidence record's ID (evd_…), as printed on the Delivery Certificate.

• delivery_idstring

  The ID of the delivery (dlv_…) the record belongs to.

• testboolean

  A test-mode delivery: nothing was sent.

• issuerobject · nullable

  Who issued the evidence, as sealed in the record: the provider's legal name and its identifier. null when the record does not say.

  2 fields of issuer

  • issuer.namestring · nullable
  • issuer.identifierstring · nullable
• senderobject · nullable

  The sender: kind (organisation or individual); for a company its name, with basis saying how the name was established, and its kennitala (Icelandic company number) when confirmed in the company registry. A person is never named. null when the record names no sender.

  4 fields of sender

  • sender.kindstring
    One of organisation individual
  • sender.basisstring · nullable

    registry: confirmed in the company registry. declared: as the sender gave it. note-only: an older record that names the company only in free text, which is not shown. Null for an individual.

    One of registry declared note-only
  • sender.namestring · nullable

    A company's name. A person is never named.

  • sender.kennitalastring · nullable

    Registry-confirmed companies only.

• recipientobject

  The recipient, never by name: kind is individual when a person identified themselves (else null), and identified gives the method, the eIDAS assurance level (High, Substantial, Low or None), whether the identity itself was verified, and when.

  2 fields of recipient

  • recipient.kindstring · nullable
    One of individual
  • recipient.identifiedobject · nullable
    4 fields of identified

    • recipient.identified.methodstring · nullable
    • recipient.identified.levelstring · nullable
      One of High Substantial Low None
    • recipient.identified.verifiedboolean
    • recipient.identified.atstring · date-time · nullable
• created_atstring · date-time · nullable

  When the delivery's first sealed event happened, in ISO 8601 (UTC); null when the record has none.

• record_sealed_atstring · date-time · nullable

  When the record as a whole was sealed, in ISO 8601 (UTC); null while it is not.

• sealsobject

  Parasend's check of the stored record: intact, every seal checks out and the record is the one asked for; items, the number of sealed events; envelope_sealed, whether the record as a whole is sealed.

  3 fields of seals

  • seals.intactboolean
  • seals.itemsinteger
  • seals.envelope_sealedboolean
• eventsarray of object

  Every sealed event, in order: Parasend's event type (event, such as delivery.created), the ETSI evidence event (etsi_event, such as SubmissionAcceptance), its time and its reason codes (reasons). Never free text or addresses.

  4 fields of events

  • events[].eventstring · nullable
  • events[].etsi_eventstring
  • events[].timestring · date-time · nullable
  • events[].reasonsarray of string
• documentsarray of object

  The delivered documents, each by its SHA-256 digest only (64 hexadecimal characters), never by file name.

  1 field of documents

  • documents[].sha256string · nullable