DcqlQuery

credentials object[]required

Array of credential queries

Array [

idstringrequired

Unique identifier for this credential query

Example: identity_credential

formatstringrequired

Credential format identifier

Possible values: [jwt_vc_json, ldp_vc, dc+sd-jwt, mso_mdoc]

Example: jwt_vc_json

multipleboolean

Whether multiple credentials can be returned for this query

Example: false

meta object

Format-specific metadata and constraints

vct_valuesstring[]

For SD-JWT VC: allowed vct values

Example: ["https://credentials.example.com/identity_credential"]

type_valuesarray[]

For W3C VC: allowed type values

Example: [["VerifiableCredential","IDCredential"]]

doctype_valuestring

For mdoc: document type value

Example: org.iso.18013.5.1.mDL

trusted_authorities object[]

Trusted authorities or trust frameworks

Array [

typestringrequired

Type of trusted authority mechanism

Possible values: [aki, etsi_tl, openid_federation]

Example: openid_federation

valuesstring[]required

Array of trusted authority identifiers

Example: ["https://trustanchor.example.com"]

]

require_cryptographic_holder_bindingboolean

Whether cryptographic holder binding is required

Example: true

claims object[]

Specific claims to request from the credential

Array [

idstring

Unique identifier for this claim query

Example: family_name_claim

pathstring[]required

Array representing path to claim in credential

Example: ["credentialSubject","familyName"]

valuesstring[]

Expected values for value matching

Example: ["Doe","Smith"]

]

claim_setsarray[]

Alternative combinations of claims

Example: [["claim1","claim2"],["claim3"]]

]

credential_sets object[]

Optional credential set constraints

Array [

optionsarray[]required

Array of credential ID combinations that satisfy the requirement

Example: [["identity_cred"],["passport_cred","visa_cred"]]

requiredboolean

Whether this credential set is required

Example: true

]

DcqlQuery

{
  "credentials": [
    {
      "id": "identity_credential",
      "format": "jwt_vc_json",
      "multiple": false,
      "meta": {
        "vct_values": [
          "https://credentials.example.com/identity_credential"
        ],
        "type_values": [
          [
            "VerifiableCredential",
            "IDCredential"
          ]
        ],
        "doctype_value": "org.iso.18013.5.1.mDL"
      },
      "trusted_authorities": [
        {
          "type": "openid_federation",
          "values": [
            "https://trustanchor.example.com"
          ]
        }
      ],
      "require_cryptographic_holder_binding": true,
      "claims": [
        {
          "id": "family_name_claim",
          "path": [
            "credentialSubject",
            "familyName"
          ],
          "values": [
            "Doe",
            "Smith"
          ]
        }
      ],
      "claim_sets": [
        [
          "claim1",
          "claim2"
        ],
        [
          "claim3"
        ]
      ]
    }
  ],
  "credential_sets": [
    {
      "options": [
        [
          "identity_cred"
        ],
        [
          "passport_cred",
          "visa_cred"
        ]
      ],
      "required": true
    }
  ]
}