Core API

Issue / Seal

Seal an EDM artifact into a cryptographically signed .ddna envelope with W3C Data Integrity Proofs. Creates an immutable, verifiable record.

POST/v1/issuescope: issue

Overview

The Issue endpoint wraps an EDM artifact in a .ddna envelope with a cryptographic proof using the eddsa-jcs-2022 cryptosuite. Each issuance creates a certificate in the DeepaData registry for audit trails.

Immutability: Once sealed, the artifact cannot be modified without invalidating the cryptographic proof. Store the envelope and certificate_id for future verification.

Issuance Pathways

The pathway parameter indicates who is sealing the artifact and in what context.

subjectSelf-issued

The subject themselves is sealing their own emotional record. Authority format: user:vp_id

delegatedApp on behalf of user

An application (e.g., therapy platform) seals records on behalf of their users. Authority format: app:platform-name

retrospectiveHistorical data

Sealing historical records that were created before DeepaData integration. Authority format: app:platform-name

Request Body

Field	Type	Required	Description
artifact	object	required	The EDM artifact from /v1/extract to seal.
pathway	string	required	'subject' \| 'delegated' \| 'retrospective'
authority	string	required	Who is sealing: 'user:id' or 'app:platform-name'
subject_ref	string	optional	Your external subject identifier (e.g., client ID).
subject_vp_id	string	optional	VitaPass subject ID for consent-linked issuance.

Example Request

curl -X POST https://www.deepadata.com/api/v1/issue \
  -H "Authorization: Bearer dda_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "artifact": { ... },
    "pathway": "delegated",
    "authority": "app:therapy-platform",
    "subject_ref": "client-12345"
  }'

Example Response

{
  "success": true,
  "data": {
    "envelope": {
      "ddna_header": {
        "version": "1.0",
        "format": "ddna",
        "created": "2026-02-24T10:30:00.000Z"
      },
      "edm_payload": {
        "meta": { "id": "edm_01HV8X3K2M...", "version": "0.5.0" },
        "core": { "anchor": "...", "spark": "..." },
        "constellation": { "emotion_primary": "relief" },
        "governance": { "jurisdiction": "HIPAA", "consent_basis": "consent" }
      },
      "proof": {
        "type": "DataIntegrityProof",
        "cryptosuite": "eddsa-jcs-2022",
        "created": "2026-02-24T10:30:01.000Z",
        "verificationMethod": "did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK#key-1",
        "proofPurpose": "assertionMethod",
        "proofValue": "z5vgFc8h2YR3..."
      }
    },
    "certificate_id": "cert_8f7a3b2c...",
    "certification_level": "standard",
    "issuance": {
      "pathway": "delegated",
      "authority": "app:therapy-platform",
      "timestamp": "2026-02-24T10:30:01.000Z",
      "issuer_did": "did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK"
    }
  },
  "meta": {
    "version": "0.5.0",
    "issued_at": "2026-02-24T10:30:01.000Z"
  }
}

Certification Levels

The certification level is determined by which checks pass during issuance.

Level	Requirements
full	standard + non-biometric confirmation
standard	basic + consent attested + governance complete
basic	Signature valid, provenance intact

Error Codes

400

Missing or invalid artifact, pathway, or authority

401

Missing or invalid API key

403

API key does not have 'issue' scope

429

Rate limit exceeded

503

Issuer credentials not configured

Extract API

Create artifacts to seal

Verify API

Verify sealed envelopes

Certificate API

Retrieve issuance certificates

VitaPass

Consent-bound issuance