Learn

VICAL

Create VICAL

Creates a Verified Issuer Certificate Authority List (VICAL) based on the policy of the requested ecosystem. Refer to VICAL ot learn more about the VICAL purpose and data structure.

SecuritybearerAuth
Request
path Parameters
ecosystemId
required
string <uuid>

The UUID of the ecosystem

Example: 87880d7e-a4d0-462e-8383-3f1e5e16865d
Responses
201

VICAL created

500

Internal Server Error. An unexpected error occurred.

post/v1/ecosystems/{ecosystemId}/vicals
Request samples 
Response samples 
application/json
{
  • "vicalIssueID": 1337,
  • "date": "2024-07-28T23:01:13.000Z"
}
Retrieve all VICALs
Retrieves all VICALs available in the requested ecosystem.


SecuritybearerAuth 
Request 
path Parameters
ecosystemId
required
string <uuid> 
The UUID of the ecosystem


 
 Example:  87880d7e-a4d0-462e-8383-3f1e5e16865d
query Parameters
limit
number  [ 1 .. 1000 ] 
 Default:  100
Range size of the list, default 100


 
 Example:  limit=2
cursor
string
Starting point for the list


 
 Example:  cursor=Y3JlYXRlZEF0PTIwMjAtMDgtMjVUMDY6NDY6MDkuNTEwWiZpZD1h
Responses 
200
VICALs retrieved


404
Not Found. The specified resource was not found.


get/v1/ecosystems/{ecosystemId}/vicals/public
Request samples 
Response samples 
application/json
{
  • "data": [
    ],
  • "nextCursor": "Y3JlYXRlZEF0PTIwMjAtMDgtMjVUMDY6NDY6MDkuNTEwWiZpZD1hNjZmZmVhNS04NDhlLTQzOWQtODBhNC1kZGE1NWY1M2UzNmM"
}
Retrieve latest VICAL
Retrieves the latest VICAL from the requested ecosystem.


Request 
path Parameters
ecosystemId
required
string <uuid> 
The UUID of the ecosystem


 
 Example:  87880d7e-a4d0-462e-8383-3f1e5e16865d
Responses 
200
VICAL retrieved


404
Not Found. The specified resource was not found.


get/v1/ecosystems/{ecosystemId}/vicals/public/latest
Request samples 
Retrieve specific VICAL
Retrieves a specific VICAL from the requested ecosystem by providing the VICAL version identifier.


Request 
path Parameters
ecosystemId
required
string <uuid> 
The UUID of the ecosystem


 
 Example:  87880d7e-a4d0-462e-8383-3f1e5e16865d
vicalIssueId
required
integer <int32> 
Unique identifier of a specific VICAL version. This numeric value is continuously increased whenever a VICAL is created.


 
 Example:  1337
Responses 
200
VICAL retrieved


404
Not Found. The specified resource was not found.


get/v1/ecosystems/{ecosystemId}/vicals/public/{vicalIssueId}
Request samples 
➔ Next to CWT credentials