Browse presentation presets - DIDx Developer Documentation

List presentation presets

Every public preset on the platform is available to you, with no setup and no permissions to request, alongside any private presets your own tenant has published. Listing returns the current catalogue; pick the one that matches what you want to verify.

curl -X GET "$BASE_URL/me-creds/api/v1/presets/presentations" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Add an optional namespace query parameter to narrow the result: ?namespace=public for the shared catalogue only, ?namespace=private for presets your tenant authored privately. Other tenants’ private presets never appear. See public and private presets. A trimmed example entry:

{
  "id": "didx:basic-identity-request",
  "author": "didx",
  "code": "basic-identity-request",
  "templateName": "Basic Identity Request",
  "templateDescription": "Standard request for basic identity information",
  "templateCredentials": [
    {
      "format": "sd-jwt-vc",
      "name": "Basic Identity Credential",
      "type": "https://test.didxtech.com/vct/didx/basic-identity",
      "trustedIssuers": [
        {
          "kind": "did",
          "did": "did:web:sarb.gov.za",
          "name": "South African Reserve Bank"
        },
        {
          "kind": "x509",
          "certificate": "-----BEGIN CERTIFICATE-----\nMIIDdzCCAl+gAwIBAgIUJ8vK...truncated...PFvKkQ==\n-----END CERTIFICATE-----",
          "name": "Department of Home Affairs"
        }
      ],
      "attributes": {
        "firstName": { "type": "string" },
        "lastName": { "type": "string" }
      }
    }
  ],
  "verifierConfig": { "signer": "did:web" }
}

At a glance: id is what you pass as presetId, templateName and templateDescription are what to scan when picking, and templateCredentials carries the request itself (which credentials the user will be asked to share, which fields come back, and which issuers count).

Inspect a single preset

When you’ve found a candidate, fetch it directly:

curl -X GET "$BASE_URL/me-creds/api/v1/presets/presentations/didx:basic-identity-request" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

What if nothing fits?

Publish your own: Create a presentation preset.
Or define a one-off: Custom presentation template.