Create Canton Validator

Edit online

Links a Canton Validator to your organization. This validator is required to create wallets or interact with the Canton network.

You can choose one of two options:
  • Shared: Use a validator hosted by IBM Digital Asset Haven. This allows you to get started quickly without hosting your own infrastructure.
  • Custom: Connect your own validator and ledger nodes using OAuth2 authentication.
HTTP request
POST/networks/{network}/validators
Authentication
Authentication Type Supported
Organization User (CustomerEmployee) Yes
Delegated User (EndUser) No
Service Account Yes
Required permissions
Networks:CantonValidators:Create (always required)
Authorization requirements
Header Type Required Description
Authorization string Yes Bearer token used to authenticate the request. See Authentication flows for details.
X-DFNS-USERACTION string Yes User Action Signature used to sign change‑inducing requests. See User Action Signing flows for details.
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
Shared validator to create Canton wallets.
Field Type Required Description
kind enum string Yes Allowed value: Shared.
name string No Nickname for the validator. Length must be 1 to 50 characters. 
curl --request POST \
  --url https://api.digitalassets.ibm.com/networks/{network}/validators \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DFNS-USERACTION: <api-key>' \
  --data '
{
  "kind": "Shared",
  "name": "My shared validator"
}
'
Response
200: Success

Example response:

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