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

201

application/json

{"vicalIssueID": 1337,
"date": "2024-07-28T23:01:13.000Z"
}

Retrieve all VICALs

Retrieves all VICALs available in the requested ecosystem.

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

200
404

application/json

{"data": [{"vicalIssueID": 1337,
"date": "2024-07-28T23:01:13.000Z",
"filename": "vical-2024-07-28-1722164473000.cbor"
}
],
"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

Response samples

404

application/json

{"code": "string",
"type": "string",
"message": "string"
}

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

Response samples

404

application/json

{"code": "string",
"type": "string",
"message": "string"
}