Skip to main content

Publish and Look Up Trusted Entities with the NXD Foundation Trust Registry

Specifications:
  • ETSI TS 119 602 V1.1.1, Annexes D to I (the EU lists of PID providers, wallet providers, access and registration certificate providers, PuB-EAA providers, and registrars and registers), in XML and JSON
  • ETSI TS 119 612 V2.4.1 (the lists of QEAA and EAA providers)
  • ETSI EN 319 132-1 (XAdES Baseline B) and ETSI TS 119 182-1 (JAdES Baseline B) for the signatures of the lists

In short​

  • The NXD Foundation (NordXDataspace Foundation) runs a trust registry for the EU Digital Identity Wallet ecosystem. It publishes the NXD Trust List: one signed list for each role, at https://trustlist.nxd.foundation/trust-lists/.
  • iGrant.io uses the NXD Trust List by default for demos, interoperability tests and all other non-production use.
  • The NXD Foundation maintains the entries. Every change re-signs all lists.
  • A wallet, issuer or verifier can use the registry in two ways:
    • Download a list and validate signers against it locally. The iGrant.io Organisation Wallet Suite does this; see Manage Trust Anchors.
    • Ask the lookup API whether a certificate chain, a DID or a key is listed: POST https://trustlist.nxd.foundation/trust-list/lookup.

The NXD Foundation Trust Registry and its users. The NXD Foundation maintains the entries. Every change regenerates and signs the eight lists, which are published at trustlist.nxd.foundation. The iGrant.io Organisation Wallet Suite downloads the lists as trust anchors and validates signers locally. Other wallets and verifiers can ask the public lookup API instead.

How the NXD Foundation Trust Registry publishes its lists, and how the iGrant.io Organisation Wallet Suite and other parties use them.

The published lists​

ListSpecificationJSON (TS 119 602)Service typesAdd in the dashboard as
NXD-TL-WalletProviders.xmlETSI TS 119 602, Annex Enxd-wallet-providers-lote.json.../SvcType/WalletSolution/Issuance, /RevocationETSI LOTE, Wallet provider
NXD-TL-PID.xmlETSI TS 119 602, Annex Dnxd-pid-providers-lote.json.../SvcType/PID/Issuance, /RevocationETSI LOTE, PID provider
NXD-TL-PubEAA.xmlETSI TS 119 602, Annex Hnxd-pub-eaa-providers-lote.json.../SvcType/PubEAA/Issuance, /RevocationETSI LOTE, PuB-EAA provider
NXD-TL-QEAA.xmlETSI TS 119 612http://uri.etsi.org/TrstSvc/Svctype/EAA/QETSI TL, QEAA provider
NXD-TL-EAA.xmlETSI TS 119 612http://uri.etsi.org/TrstSvc/Svctype/EAAETSI TL, EAA provider
NXD-TL-WRPAC.xmlETSI TS 119 602, Annex Fnxd-wrpac-providers-lote.json.../SvcType/WRPAC/Issuance, /RevocationETSI LOTE, Access certificate provider
NXD-TL-WRPRC.xmlETSI TS 119 602, Annex Gnxd-wrprc-providers-lote.json.../SvcType/WRPRC/Issuance, /RevocationETSI LOTE, Registration certificate provider
NXD-TL-Registrars.xmlETSI TS 119 602, Annex Inxd-registrars-and-registers-lote.json.../SvcType/RegisterNo role yet

... stands for http://uri.etsi.org/19602. The service type of an entry is the issuance type of its list. A service that only publishes validity status has the revocation type.

What every list has:

Lists of trusted entities (TS 119 602)Trusted lists (TS 119 612)
Scheme operatorNXD FoundationNXD Foundation
Scheme territoryEU, as Annexes D to I fix itSE, the country where the scheme operator is established
Status of a servicehttp://uri.etsi.org/19602/<list type>/SvcStatus/notified, or .../withdrawnhttp://uri.etsi.org/TrstSvc/TrustedList/Svcstatus/granted, or .../withdrawn
SignatureXAdES Baseline B (XML, enveloped, ECDSA with SHA-256, exclusive canonicalisation); a JWS in a signature member (JSON)XAdES Baseline B
Next updateSix months after the issue dateSix months after the issue date

Every change of an entry publishes all lists again, with a new sequence number and a new issue date. A withdrawn service stays in its list, so you can see its history, but it no longer validates any certificate.

Legacy lists. The registry also serves two older lists in the TS 119 612 format at https://trustlist.nxd.foundation/trust-lists/legacy/:

  • NXD-TL.xml, the earlier NXD Trust List.
  • EWC-TL.xml, the list of the EU Digital Identity Wallet Consortium.

Their entries can be identified by a certificate, a DID, a key ID (kid), a JWKS URI, a subject key identifier or a subject name. The per-role lists take X.509 certificates only.

Look up a certificate, DID or key​

POST https://trustlist.nxd.foundation/trust-list/lookup with a JSON body that has exactly one of:

MemberContent
x5cThe certificate chain, leaf first, as base64 DER: 1 to 8 certificates
didA DID, for example did:web:... or did:key:...
kidA key identifier
jwksUri and kidA JWKS URI, with the kid of the key in that key set. A jwksUri alone is refused.

A body with none of these is refused with 400: "Request body must contain one of x5c, kid, did, or jwksUri with kid". Other invalid bodies are refused with 422, for example a jwksUri without kid, two of these members, or more than 8 certificates. A body of more than 64 KiB is refused with 413.

curl -X POST "https://trustlist.nxd.foundation/trust-list/lookup" \
-H "Content-Type: application/json" \
-d '{ "x5c": ["MIIC...", "MIIB..."] }'

How it matches. The lookup searches the lists in two tiers, and always both:

  1. The eight per-role lists.
    • The chain must validate to a certificate in one of these lists. The certificate store of the operating system is never used, so a certificate from a public CA does not match on that basis alone.
    • A match is end-entity when the entry lists the presented certificate itself, and chain when the entry lists a CA that the certificate validates up to.
    • A DID, kid or JWKS URI goes straight to the legacy tier: the per-role lists hold only certificates.
  2. The legacy lists, NXD-TL.xml first, then EWC-TL.xml.

The response lists every entry that matched, the per-role lists first. A certificate can be listed in more than one place, so read all entries, not only the first:

{
"match": true,
"entries": [
{
"status": "granted",
"matchType": "end-entity",
"trustList": {
"name": "NXD-TL-EAA.xml",
"url": "https://trustlist.nxd.foundation/trust-lists/NXD-TL-EAA.xml",
"schemeName": "SE:EN_NXD Foundation - EAA Providers"
},
"certificateValid": true,
"certificateDetails": [
{
"subject": "C=SE,O=Example Issuer AB,CN=Example Issuer AB",
"issuer": "C=SE,O=Example Issuer AB,CN=Example Issuer CA",
"notValidBefore": "2026-07-14T16:26:36+00:00",
"notValidAfter": "2027-07-14T16:26:35+00:00",
"sha256Fingerprint": "5ae5a344...",
"subjectKeyIdentifier": "3566E350...",
"authorityKeyIdentifier": "398E5361..."
}
],
"provider": { "tSPName": "Example Issuer AB", "countryName": "SE" },
"service": {
"serviceTypeIdentifier": "http://uri.etsi.org/TrstSvc/Svctype/EAA",
"serviceStatus": "http://uri.etsi.org/TrstSvc/TrustedList/Svcstatus/granted",
"serviceName": "Example EAA Issuer",
"digitalIdentity": ["MIIC..."]
},
"permittedCredentials": [],
"prohibitedCredentials": [
{ "format": "dc+sd-jwt", "vct": "urn:eudi:pid:1" },
{ "format": "mso_mdoc", "doctype": "eu.europa.ec.eudi.pid.1" },
{ "format": "dc+sd-jwt", "vct": "WalletUnitAttestation" }
]
}
]
}

When nothing matches, the answer is {"match": false, "entries": []}.

  • An expired certificate: in the per-role lists, a listed certificate that is expired or not valid yet still matches. The entry then has certificateValid: false and a warning in warnings, for example "Certificate expired on 2026-01-31". In the legacy lists, it does not match.
  • A withdrawn service: its certificates do not match.

What a listed entity may issue​

Each match carries two arrays of credential types:

  • permittedCredentials: what the entity may issue.
  • prohibitedCredentials: what it must never issue.

The defaults follow from the list:

ListpermittedCredentialsprohibitedCredentials
PID providersThe PID: dc+sd-jwt with vct urn:eudi:pid:1, mso_mdoc with doctype eu.europa.ec.eudi.pid.1The wallet unit attestation
Wallet providersThe wallet unit attestation: dc+sd-jwt with vct WalletUnitAttestationThe PID
All other listsEmpty: the list grants a category, such as EAA, not concrete typesThe PID and the wallet unit attestation

The NXD Foundation can change these defaults, so the live answers can differ from this table. They shape the lookup answer only; the signed lists do not contain them. When one certificate matches several entries that do not agree, use the strictest answer: refuse a type that any of its matches prohibits.

Reading prohibitedCredentials: A verifier that uses the lookup should refuse a credential whose type is in prohibitedCredentials of its issuer's match, even when the issuer is listed. An EAA provider on the NXD Trust List must never be accepted as the issuer of a PID.

In the iGrant.io Organisation Wallet Suite​

  • Trust anchors: add the lists that your checks need, with the kind and role of the table above. See Manage Trust Anchors.
  • Local checks: the Organisation Wallet Suite downloads each list, checks its signature and validates signers against it locally. It does not call the lookup API, so it does not send the registry the certificates of the parties that it checks.
  • Refresh: it downloads a list again at its next update, or after 24 hours if that is earlier. A new entry therefore reaches your checks within a day; select Refresh the list to get it at once.
  • Getting listed: iGrant.io adds your organisation to the NXD Trust List for the test network, after it has verified your request. See Register on a Trust List.