Skip to main content
Version: v4 (next)

List Credential Schemas

MOD-CS-QRY-1

List existing credential schemas, optionally filtered by ecosystem, onboarding mode, or modification time.

Query Parameters​

FlagDescriptionMandatory
--ecosystem_idFilter by the numeric Ecosystem ID that owns the schemasno
--modified_afterOnly schemas modified after this RFC 3339 timestampno
--response_max_sizeMax items to return (1-1024, default 64)no
--only-activeShow only non-archived schemasno
--issuer-onboarding-modeFilter by issuer onboarding mode (open, ecosystem-validation-process, grantor-validation-process)no
--verifier-onboarding-modeFilter by verifier onboarding mode (same values as issuer)no
--holder-onboarding-modeFilter by holder onboarding mode (issuer-validation-process, permissionless)no

Execute the Query​

veranad query cs list-schemas --node $NODE_RPC --output json

Examples with filters:

veranad query cs list-schemas --ecosystem_id 3 --modified_after "2025-08-01T16:42:59Z" --node $NODE_RPC --output json
veranad query cs list-schemas --ecosystem_id 3 --response_max_size 10 --only-active --node $NODE_RPC --output json

Example response​

{
  "schemas": [
    {
      "id": "3",
      "created": "2025-10-06T07:14:58.914878265Z",
      "modified": "2025-10-20T12:15:27.945453876Z",
      "json_schema": "{ ... }",
      "issuer_grantor_validation_validity_period": 1,
      "verifier_grantor_validation_validity_period": 1,
      "issuer_validation_validity_period": 1,
      "verifier_validation_validity_period": 1,
      "holder_validation_validity_period": 1,
      "issuer_onboarding_mode": "ISSUER_ONBOARDING_MODE_OPEN",
      "verifier_onboarding_mode": "VERIFIER_ONBOARDING_MODE_OPEN"
    }
  ]
}

Each entry is a CredentialSchema. The full v4 field set is documented in Get a Credential Schema; fields set to their default (for example ecosystem_id 0 or an unspecified onboarding mode) are omitted from JSON output.