Browse credential presets

List credential presets

Every preset published on the platform is available to you, with no setup and no permissions to request. Listing returns the current catalogue; pick the one that matches what you want to issue. The API exposes a separate listing per credential format. Use the one for the format you’re after, or the generic listing if you want everything in one call:

GET /presets/credentials/sd-jwt — SD-JWT presets only
GET /presets/credentials/mdoc — mDoc presets only
GET /presets/credentials — both formats together

curl -X GET "https://test.didxtech.com/me-creds/api/v1/presets/credentials/sd-jwt" \
  -H "Authorization: Bearer <access_token>"

A trimmed example entry:

{
  "credentialFormat": "sd-jwt",
  "id": "didx:basic-identity",
  "author": "didx",
  "code": "basic-identity",
  "templateName": "Basic Identity Credential",
  "templateType": "https://didx.co.za/vct/didx/basic-identity",
  "templateDescription": "Standard basic identity credential",
  "templateAttributes": {
    "firstName": {
      "type": "string",
      "name": "First Name",
      "required": true,
      "alwaysDisclosed": false
    },
    "lastName": {
      "type": "string",
      "name": "Last Name",
      "required": true,
      "alwaysDisclosed": false
    }
  },
  "issuerConfig": { "signer": "did:web" }
}

What to look at

Field	What it tells you
`id`	Pass this as `presetId` when issuing
`author`	The publisher’s tenant alias (e.g. `didx`)
`templateName`, `templateDescription`	Human-readable summary
`credentialFormat`	`sd-jwt` or `mdoc`. Determines which wallets and verifiers can use the credential
`templateAttributes`	The keys you supply under `attributes` when issuing
`templateAttributes.*.required`	Whether you must supply that key
`templateAttributes.*.alwaysDisclosed`	If `true`, the value is shared whenever the credential is presented

Inspect a single preset

When you’ve found a candidate, fetch it directly. The same format-split applies — GET /presets/credentials/sd-jwt/:id for SD-JWT, GET /presets/credentials/mdoc/:id for mDoc, or GET /presets/credentials/:id for the generic lookup:

curl -X GET "https://test.didxtech.com/me-creds/api/v1/presets/credentials/sd-jwt/didx:basic-identity" \
  -H "Authorization: Bearer <access_token>"

What if nothing fits?

Publish your own: Create an SD-JWT credential preset or Create an mDoc credential preset.
Or define a one-off: Custom credential template.

Overview

User Onboarding

Issuance

Verification

Webhooks

Custom Templates (advanced)

Errors

List credential presets

What to look at

Inspect a single preset

What if nothing fits?

​List credential presets

​What to look at

​Inspect a single preset

​What if nothing fits?

List credential presets

What to look at

Inspect a single preset

What if nothing fits?