v18

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-20112546.2 KB
Verifier Management API

Creates a new verification process with the given attributes

post/management/api/verifications

Request body

accepted_issuer_didsstring[] nullable

List of dids from issuers whose credentials are accepted for this verification. Will be evaluated before trust anchor. If not specified and no trust anchor specified all dids are trusted.

jwt_secured_authorization_requestboolean

Toggle whether the request-object is available as plain object oras jwt object signed by the verifier as additional security measure

response_mode'direct_post' | 'direct_post.jwt'

Supported response_mode as defined in OID4VP

Example request

{
  "accepted_issuer_dids": [
    "did:example:12345"
  ],
  "trust_anchors": [
    {
      "did": "did:example:12345",
      "trust_registry_uri": "https://trust-reg.trust-infra.swiyu-int.admin.ch"
    }
  ],
  "configuration_override": {
    "external_url": "https://www.example.com/verifier",
    "verifier_did": "did:webvh:mySCID12345213:identifier-reg.trust-infra.swiyu.admin.ch:api:v1:did:00000000-0000-0000-0000-000000000000",
    "verification_method": "did:webvh:mySCID12345213:identifier-reg.trust-infra.swiyu.admin.ch:api:v1:did:00000000-0000-0000-0000-000000000000#myVerificationMethod-xx",
    "key_id": "myOverrideHSMKeyId01",
    "key_pin": "11111",
    "client_metadata": {
      "client_name": "My Client Name",
      "client_name#en": "My Client Name",
      "client_name#de-CH": "Mein Kundenname",
      "logo_uri": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAAC0lEQVQI12NgAAIABQAABjE+ibYAAAAASUVORK5CYII="
    }
  },
  "dcql_query": {
    "credentials": [
      {
        "id": "identity_credential_dcql",
        "format": "dc+sd-jwt",
        "meta": {
          "vct_values": [
            "https://credentials.example.com/identity_credential"
          ]
        },
        "claims": [
          {
            "path": [
              "given_name"
            ]
          },
          {
            "path": [
              "family_name"
            ]
          },
          {
            "path": [
              "address",
              "street_address"
            ]
          }
        ],
        "require_cryptographic_holder_binding": true
      },
      {
        "id": "university_degree_dcql",
        "format": "dc+sd-jwt",
        "meta": {
          "vct_values": [
            "https://credentials.example.com/university_degree"
          ]
        },
        "claims": [
          {
            "path": [
              "degree_name"
            ]
          },
          {
            "path": [
              "graduation_year"
            ]
          }
        ]
      }
    ],
    "credential_sets": [
      {
        "options": [
          [
            "identity_credential_dcql"
          ],
          [
            "university_degree_dcql"
          ]
        ],
        "required": true
      }
    ]
  },
  "verification_purpose": {
    "scope": "com.example.age_verification",
    "purpose_name": {
      "default": "Age Verification",
      "de-ch": "Altersverifikation"
    },
    "purpose_description": {
      "default": "Age Verification required for xyz"
    }
  }
}

Response

Verification created