Core API

Certificate

Retrieve the issuance certificate for a sealed artifact. Certificates provide an audit trail of how and when an artifact was issued.

GET/v1/certificate/:idscope: verify

Overview

When an artifact is sealed via the Issue endpoint, a certificate record is created containing metadata about the issuance. Use this endpoint to retrieve certificate details for audit, compliance, or verification purposes.

Important: Certificates provide issuance metadata only. They do not constitute legal advice, regulatory approval, or validation of consent quality.

Path Parameters

ParameterTypeRequiredDescription
idstring (UUID)requiredThe certificate ID returned from the Issue endpoint.

Example Request

curl https://www.deepadata.com/api/v1/certificate/cert_01HV8X3K2M... \
  -H "Authorization: Bearer dda_live_YOUR_KEY"

Example Response

{
  "success": true,
  "data": {
    "certificate": {
      "id": "cert_01HV8X3K2M...",
      "issuer_did": "did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK",
      "pathway": "subject",
      "authority": "deepadata.com",
      "certification_level": "full",
      "checks": {
        "schema_valid": true,
        "provenance_intact": true,
        "consent_attested": true,
        "governance_complete": true,
        "non_biometric": true
      },
      "issued_at": "2026-02-24T10:30:05.000Z"
    },
    "disclaimer": "DeepaData certification attests that this artifact was issued correctly. It does not constitute legal advice, regulatory approval, or validation of consent quality."
  }
}

Response Fields

certificate.id

Unique certificate identifier

certificate.issuer_did

DID of the organization or individual that issued the artifact

certificate.pathway

Issuance pathway: "subject", "delegated", or "retrospective"

certificate.authority

Authority that certified the issuance (e.g., "deepadata.com")

certificate.certification_level

Level of certification: "basic", "standard", or "full"

certificate.checks

Object containing individual certification check results

certificate.issued_at

ISO 8601 timestamp of when the certificate was created

Error Codes

400

Certificate ID is required

401

Missing or invalid API key

403

API key does not have 'verify' scope

404

Certificate not found

429

Rate limit exceeded

Related