v8

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-05730512.7 KB

Credentials

Issue a credential directly (management)

Issue an SD-JWT VC (Selective-Disclosure JWT Verifiable Credential) to a holder. You provide a template UUID, the holder public JWK (JSON Web Key), and claim values. The API returns the issued credential identifier and serialized credential.

post/v1/credentials/issue

Request body

template_idstring uuid required

UUID of the credential template to issue from.

Example request

{
  "template_id": "5588f83f-620b-4614-8ffa-933634a0b708",
  "holder_jwk": {
    "crv": "P-256",
    "kty": "EC",
    "x": "Y9feBRecVo4n0vrl8iFCTuaC9y3XMEZd3pxaE-yMdW4",
    "y": "YP8zky5B1mzZO2zHX2aSAemQKh4Tx6WMVclUj1W7S2Q"
  },
  "claims": {
    "given_name": "Ada",
    "tier": "gold"
  }
}

Response

The credential was issued.

credential_idstring uuid

Unique identifier of the issued credential.

vctstring

VCT (Verifiable Credential Type) value of the issued credential.

sd_jwtstring

Serialized SD-JWT VC (Selective-Disclosure JWT Verifiable Credential). The captured value was redacted.

status_idxinteger

Status-list index assigned to the issued credential.

Example response

{
  "credential_id": "6585d444-c19b-40e8-a64a-3e24a838214c",
  "vct": "AirlineLoyalty",
  "sd_jwt": "<redacted>",
  "status_idx": 34
}