---
id: config-preview-digital-wallet-open-id-trust-source
title: "Preview trust source"
description: "Reads a list as [Add trust source](/docs/openid4vc-api/config-create-digital-wallet-open-id-trust-source) reads it, and saves nothing. Use it to choose the `usedFor` role of a new trust source before you add it: the answer tells how many entries the list has, the roles that the list gives its entries, and how many entries have no role. The add and the edit form of the dashboard call it when the URL field or the list signer certificate field loses the focus."
sidebar_label: "Preview trust source"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "post api-method"
info_path: docs/openid4vc-api/igrant-io-api-documentation
custom_edit_url: null
---

> **Build this with an AI coding agent.** Install the iGrant.io Agent Skills, then ask your agent to build the integration:
>
> ```bash
> npx skills add L3-iGrant/skills
> ```


import ApiTabs from "@theme/ApiTabs";
import DiscriminatorTabs from "@theme/DiscriminatorTabs";
import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
import MimeTabs from "@theme/MimeTabs";
import ParamsItem from "@theme/ParamsItem";
import ResponseSamples from "@theme/ResponseSamples";
import SchemaItem from "@theme/SchemaItem";
import SchemaTabs from "@theme/SchemaTabs";
import Markdown from "@theme/Markdown";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";

<h1 className={"openapi__heading"}>Preview trust source</h1>

<MethodEndpoint method={"post"} path={"/v4/config/ows/trust/sources/preview"}></MethodEndpoint>



Reads a list as [Add trust source](/docs/openid4vc-api/config-create-digital-wallet-open-id-trust-source) reads it, and saves nothing. Use it to choose the `usedFor` role of a new trust source before you add it: the answer tells how many entries the list has, the roles that the list gives its entries, and how many entries have no role. The add and the edit form of the dashboard call it when the URL field or the list signer certificate field loses the focus.

An entry is one listed certificate of a service; a service without a certificate is one entry. A trust source uses the entries that have its role, and the entries whose list names no role (but never for `status_issuer`). So the number of entries that a trust source with the role `R` would use is the `entryCount` of `R` in `entryRoles`, plus `entryCountWithoutRole` (not for `status_issuer`).

The request has the members of the add of a list, without `usedFor`. The operation refuses what the add refuses: a list that the wallet cannot download or read as a list of the `kind`, a list with no entries, and a list whose signature does not verify with the `signerCertificates` that you give. The answer is then `400` with `errorId` `trust_source.list_not_usable` (`The list cannot be used: <reason>`). A trust anchor has no list to read (`A trust anchor has no list to download`).

API key scope: `trust-sources:create` (the older `trust-anchors:create` still works for a period).


## Request

<MimeTabs className={"openapi-tabs__mime"}><TabItem label={"application/json"} value={"application/json-schema"}><details style={{}} className={"openapi-markdown__details mime"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-mime"}><h3 className={"openapi-markdown__details-summary-header-body"}>Body</h3><strong className={"openapi-schema__required"}>required</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}><div style={{"marginTop":"1rem","marginBottom":"1rem"}}>

The list to read. A member that the operation does not declare is refused (`<name>: unknown field`).

</div></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"kind"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** [`etsi_trusted_list`, `etsi_lote`]"} schema={{"type":"string","enum":["etsi_trusted_list","etsi_lote"],"description":"Required. `etsi_trusted_list`: an ETSI TS 119 612 trusted list (XML). `etsi_lote`: an ETSI TS 119 602 list of trusted entities (XML or JSON). `trust_anchor` is refused: a trust anchor has no list.","example":"etsi_lote"}}></SchemaItem><SchemaItem collapsible={false} name={"url"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"Required. The https URL of the list, at most 2048 characters.","example":"https://trustlist.nxd.foundation/trust-lists/NXD-TL-PID.xml"}}></SchemaItem><SchemaItem collapsible={false} name={"signerCertificates"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"Optional. PEM text with the certificates that sign the list, at least one. The wallet then refuses a list whose signature does not verify, and `list.signatureVerified` is `true` in the answer.","example":"-----BEGIN CERTIFICATE-----\nMIIC...\n-----END CERTIFICATE-----"}}></SchemaItem></ul></details></TabItem></MimeTabs><div><div><ApiTabs label={undefined} id={undefined}><TabItem label={"200"} value={"200"}><div>

What the list gives its entries. Nothing is saved.

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><span className={"openapi-schema__container"}><strong className={"openapi-schema__property"}>list</strong><span className={"openapi-schema__name"}> object</span><span className={"openapi-schema__divider"}></span><span className={"openapi-schema__required"}>required</span></span></summary><div style={{"marginLeft":"1rem"}}><div style={{"marginTop":".5rem","marginBottom":".5rem"}}>

The list, as the wallet read it.

</div><SchemaItem collapsible={false} name={"listType"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","nullable":true,"description":"The list type URI of the list. `null` when the list gives none.","example":"http://uri.etsi.org/19602/LoTEType/EUPIDProvidersList"}}></SchemaItem><SchemaItem collapsible={false} name={"schemeName"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","nullable":true,"description":"The scheme name of the list. The add takes it as the name of a trust source without a `name`.","example":"EU:EN_NXD Foundation - PID Providers"}}></SchemaItem><SchemaItem collapsible={false} name={"signatureVerified"} required={true} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean","description":"`true` when the wallet verified the signature of the list with the `signerCertificates` of the request. `false` without `signerCertificates`.","example":true}}></SchemaItem><SchemaItem collapsible={false} name={"entryCount"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"All the entries of the list.","example":17}}></SchemaItem><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><span className={"openapi-schema__container"}><strong className={"openapi-schema__property"}>entryRoles</strong><span className={"openapi-schema__name"}> object[]</span><span className={"openapi-schema__divider"}></span><span className={"openapi-schema__required"}>required</span></span></summary><div style={{"marginLeft":"1rem"}}><div style={{"marginTop":".5rem","marginBottom":".5rem"}}>

The roles that the list gives its entries, in the order of the roles, each with its number of entries. A role that no entry has is not in the array.

</div><li><div style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem","paddingBottom":".5rem"}}>Array [</div></li><SchemaItem collapsible={false} name={"role"} required={false} schemaName={"object"} qualifierMessage={undefined} schema={{"type":"string","title":"TrustRole","description":"A role of a trust source entry: what the entry vouches for. A list gives the roles of its entries (by its list type and the service type of each entry); the `usedFor` of its trust source can only narrow them. An entry whose list gives it no role has the `usedFor` role of its trust source, except `status_issuer`, which only a service type gives. A trust anchor has the role that the organisation gives (its `usedFor`). A PID needs a `pid_provider`, an mDL an `mdl_issuer`, another credential any issuer role.\n\n- `wallet_provider`: signs Wallet Unit Attestations and key attestations (LoTE list type `EUWalletProvidersList`).\n- `pid_provider`: signs a PID (LoTE list type `EUPIDProvidersList`).\n- `qeaa_provider`: signs a QEAA (an ETSI TS 119 612 trusted list service of type `EAA/Q`).\n- `pub_eaa_provider`: signs a PuB-EAA (LoTE list type `EUPubEAAProvidersList`, or a trusted list service of type `EAA/Pub-EAA`).\n- `eaa_provider`: signs a non-qualified EAA (a trusted list service of type `EAA`, or a trust anchor that the organisation marks).\n- `mdl_issuer`: the IACA of an mDL Document Signer (a trust anchor that the organisation marks).\n- `status_issuer`: signs the Status List Token of a credential (ETSI services `SvcType/PID/Revocation` and `SvcType/PubEAA/Revocation`, or a trust anchor that the organisation marks). It is not an issuer role.\n- `access_certificate_provider`: issues the access certificates of relying parties, which sign their presentation requests and signed metadata (LoTE list type `EUWRPACProvidersList`, or a trusted list service of type `WRPAC`).\n- `registration_certificate_provider`: issues the registration certificates of relying parties (LoTE list type `EUWRPRCProvidersList`).\n\nThe issuer roles are `pid_provider`, `qeaa_provider`, `pub_eaa_provider`, `eaa_provider` and `mdl_issuer`; the filter value `issuer` names them all.","enum":["wallet_provider","pid_provider","qeaa_provider","pub_eaa_provider","eaa_provider","mdl_issuer","status_issuer","access_certificate_provider","registration_certificate_provider"],"example":"wallet_provider"}}></SchemaItem><SchemaItem collapsible={false} name={"entryCount"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"The number of entries of the list with this role.","example":17}}></SchemaItem><li><div style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem"}}>]</div></li></div></details></SchemaItem><SchemaItem collapsible={false} name={"entryCountWithoutRole"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"The entries whose list names no role. A trust source uses them for its role, but never for `status_issuer`.","example":0}}></SchemaItem></div></details></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"list\": {\n    \"listType\": \"http://uri.etsi.org/19602/LoTEType/EUPIDProvidersList\",\n    \"schemeName\": \"EU:EN_NXD Foundation - PID Providers\",\n    \"signatureVerified\": true,\n    \"entryCount\": 17,\n    \"entryRoles\": [\n      {\n        \"role\": \"wallet_provider\",\n        \"entryCount\": 17\n      }\n    ],\n    \"entryCountWithoutRole\": 0\n  }\n}"} language={"json"}></ResponseSamples></TabItem><TabItem label={"Example"} value={"Example"}><ResponseSamples responseExample={"{\n  \"list\": {\n    \"listType\": \"http://uri.etsi.org/19602/LoTEType/EUPIDProvidersList\",\n    \"schemeName\": \"EU:EN_NXD Foundation - PID Providers\",\n    \"signatureVerified\": true,\n    \"entryCount\": 17,\n    \"entryRoles\": [\n      {\n        \"role\": \"pid_provider\",\n        \"entryCount\": 17\n      }\n    ],\n    \"entryCountWithoutRole\": 0\n  }\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"400"} value={"400"}><div>

The body has a member that the operation does not declare (`<name>: unknown field`), or a value is not valid: `kind must be one of trust_anchor, etsi_trusted_list, etsi_lote`, `A trust anchor has no list to download` (for `trust_anchor`), `url is required for a list`, `url must be an https URL of at most 2048 characters`, `signerCertificates must have at least one PEM certificate`. A list that the wallet cannot use gives `errorId` `trust_source.list_not_usable` (`The list cannot be used: <reason>`; the reason is the HTTP status, the read failure, the signature failure or `the list has no entries`). Also when the organisation is unknown or has no deployed wallet.

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem><SchemaItem collapsible={false} name={"errorKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A text code of the refusal that does not change when the text changes. Only some refusals have it, for example `organisation_suspended`, `feature_disabled`, `service_not_installed` or `purpose_exists`. Some refusals have more members: `feature_disabled` has `feature`, and `service_not_installed` has `service` (the service that is not installed: `wallet` or `consent`)."}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\",\n  \"errorKey\": \"string\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"401"} value={"401"}><div>

The `Authorization` header is missing, or the API key or token is not valid.

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem><SchemaItem collapsible={false} name={"errorKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A text code of the refusal that does not change when the text changes. Only some refusals have it, for example `organisation_suspended`, `feature_disabled`, `service_not_installed` or `purpose_exists`. Some refusals have more members: `feature_disabled` has `feature`, and `service_not_installed` has `service` (the service that is not installed: `wallet` or `consent`)."}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\",\n  \"errorKey\": \"string\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"403"} value={"403"}><div>

The API key or token does not allow this call. An API key without the scope of the operation gets the older body `{"Code", "Message"}`. An `X-SandboxOrgId` header that names another sandbox organisation than the one of the API key gets `{"errorCode", "errorDescription"}`. When a platform admin has turned off the feature of the operation for the organisation, the answer has `errorKey` `feature_disabled` and the member `feature` (the name of the feature).

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><div><span className={"badge badge--info"}>anyOf</span><SchemaTabs><TabItem label={"MOD1"} value={"0-item-properties"}><SchemaItem collapsible={false} name={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem><SchemaItem collapsible={false} name={"errorKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A text code of the refusal that does not change when the text changes. Only some refusals have it, for example `organisation_suspended`, `feature_disabled`, `service_not_installed` or `purpose_exists`. Some refusals have more members: `feature_disabled` has `feature`, and `service_not_installed` has `service` (the service that is not installed: `wallet` or `consent`)."}}></SchemaItem></TabItem><TabItem label={"Older error body"} value={"1-item-properties"}><SchemaItem collapsible={false} name={"Code"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"The HTTP status.","example":403}}></SchemaItem><SchemaItem collapsible={false} name={"Message"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"What went wrong.","example":"Unauthorised access;User doesn't have enough permissions;"}}></SchemaItem></TabItem></SchemaTabs></div></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{}"} language={"json"}></ResponseSamples></TabItem><TabItem label={"Example"} value={"Example"}><ResponseSamples responseExample={"{\n  \"Code\": 403,\n  \"Message\": \"Unauthorised access;User doesn't have enough permissions;\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"500"} value={"500"}><div>

Unexpected server error.

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem><SchemaItem collapsible={false} name={"errorKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A text code of the refusal that does not change when the text changes. Only some refusals have it, for example `organisation_suspended`, `feature_disabled`, `service_not_installed` or `purpose_exists`. Some refusals have more members: `feature_disabled` has `feature`, and `service_not_installed` has `service` (the service that is not installed: `wallet` or `consent`)."}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\",\n  \"errorKey\": \"string\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem></ApiTabs></div></div>
      