List trust authority

GET 
/v2/config/digital-wallet/openid/trust-authorities

Lists the trust authorities that the organisation created. Filter with type, and with name_contains and value_contains (parts of the name or the value, case-insensitive). The largest value of limit is 100; a larger value gives HTTP 400.

Request

Query Parameters

offset integerrequired

Default value: 0

Number of records to skip for pagination. A negative or unreadable value falls back to 0.

limit integerrequired

Default value: 10

Maximum number of records to return per page.

type stringrequired

Possible values: [ETSI_TL, ETSI_TL_JSON, X509_CA]

Only the trust authorities of this type.

name_contains stringrequired

Only the trust authorities whose name contains this text (case-insensitive).

value_contains stringrequired

Only the trust authorities whose value contains this text (case-insensitive).

Responses

200

The service returns the trust authorities and the pagination data.

Response Headers

application/json

Schema

Schema

trustAuthority object[]required
The trust authorities on the current page.
Array [
id stringrequired
Unique identifier (UUID) of the trust authority.
type stringrequired
Possible values: [ETSI_TL, ETSI_TL_JSON, X509_CA]
Type of the trust authority: ETSI_TL (an ETSI TS 119 612 trusted list in XML), ETSI_TL_JSON (an ETSI TS 119 602 list of trusted entities in JSON) or X509_CA (CA certificates in PEM). The service changes the value to upper case.
value stringrequired
For ETSI_TL and ETSI_TL_JSON, the URL of the list. For X509_CA, the PEM text of the CA certificates and CRLs, in a normalised form.
name stringrequired
Name of the trust authority. The value is an empty string when the create or update request gave no name.
disabled booleanrequired
When true, this trust authority is disabled and not used for credential or verifier trust validation.
createdAt numberrequired
Unix timestamp (in seconds) when this trust authority was registered.
updatedAt numberrequired
Unix timestamp (in seconds) when this trust authority was last modified.
]
pagination objectrequired

currentPage integer

Current page number

totalItems integer

Total number of items available

totalPages integer

Total number of pages based on limit

limit integer

Number of items per page

hasPrevious boolean

Indicates if there's a previous page

hasNext boolean

Indicates if there's a next page

Example (from schema)

{
  "trustAuthority": [
    {
      "id": "b7d1f4a2-8c3e-4a91-9f52-0d3c6e7a1b45",
      "type": "ETSI_TL",
      "value": "https://raw.githubusercontent.com/EWC-consortium/ewc-trust-list/refs/heads/main/EWC-TL.xml",
      "name": "EU Trust List",
      "disabled": false,
      "createdAt": 1747011600,
      "updatedAt": 1747011600
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalItems": 25,
    "totalPages": 3,
    "limit": 10,
    "hasPrevious": false,
    "hasNext": true
  }
}

400

limit is larger than 100, or a query parameter is not valid.

Response Headers

application/json

Schema

Schema

errorCode integerrequired
errorDescription stringrequired

Example (from schema)

{
  "errorCode": 400,
  "errorDescription": "Bad input parameter"
}

401

Unauthorized

Response Headers

application/json

Schema

Schema

errorCode integerrequired
errorDescription stringrequired

Example (from schema)

{
  "errorCode": 400,
  "errorDescription": "Bad input parameter"
}

500

Internal server error

Response Headers

application/json

Schema

Schema

errorCode integerrequired
errorDescription stringrequired

Example (from schema)

{
  "errorCode": 400,
  "errorDescription": "Bad input parameter"
}

Loading...