List Canton Validators

Edit online

Retrieves the list of configured Canton Validators in your organization.

HTTP request
GET/networks/{network}/validators
Authentication
Authentication Type Supported
Organization User (CustomerEmployee) Yes
Delegated User (EndUser) No
Service Account Yes
Required permissions
Networks:CantonValidators:Read (always required)
Authorization requirements
Header Type Required Description
Authorization string Yes Bearer token used to authenticate the request. See Authentication flows for instructions on generating this token.
Path parameters
Parameter Type Required Description
network enum string Yes Canton network identifier. Supported values: canton, canton-devnet, canton-testnet.
Query parameters
Parameter Type Default Description
limit integer 50 Maximum number of items to return. Must be between 1 and 500.
paginationToken string None Opaque token used to retrieve the next page of results. Returned as nextPageToken in the previous response. Minimum length is 1.
Request body
curl --request GET \
  --url 'https://api.digitalassets.ibm.com/networks/{network}/validators?limit=50' \
  --header 'Authorization: Bearer <token>'
Response
200: Success

Example response:

{
  "items": [
    {
      "id": "cv-7jeof-m584r-p35ucm37ko3cqgts",
      "orgId": "or-30tnh-itmjs-s235s5ontr3r23h2",
      "network": "Canton",
      "kind": "Shared",
      "dateCreated": "<string>",
      "partyHint": "<string>",
      "name": "<string>"
    }
  ],
  "nextPageToken": "<string>"
}