Trusted Nodes List
Core API requests are sent to a node of the environment you use. The Trusted Nodes List (TNL) API returns the signed list of approved nodes for each environment. Learn what the list is, how to verify it, or browse it.
Base URL
https://tnl.ebsi.eu
Endpoints
| Path | Returns |
|---|---|
/ | Index of the links below |
/tnl.json | The node list |
/tnl.json.sig | Custodian signature(s) over tnl.json (binary OpenPGP) |
/trusted-keys.json | Custodian public keys and threshold |
/trusted-keys.json.sig | Europeum signature over trusted-keys.json (binary OpenPGP) |
/keylist-key.asc | Europeum key-list signing public key (armored OpenPGP) |
All endpoints accept GET and HEAD, and any origin can read them (CORS).
Responses
| Status | Meaning |
|---|---|
200 | The file. |
304 | Unchanged since your ETag. Keep the list you already verified. |
404 | {"error":"not found"}: unknown path or method, or the files are not loaded yet. |
Caching
Every file has an ETag and Cache-Control: public, max-age=300. Send the ETag back in If-None-Match to get 304 Not Modified when nothing changed:
curl -sI https://tnl.ebsi.eu/tnl.json
# HTTP/1.1 200 OK
# etag: "3f1c…9a2e"
curl -s -o /dev/null -w '%{http_code}\n' -H 'If-None-Match: "3f1c…9a2e"' https://tnl.ebsi.eu/tnl.json
# 304