GET/authorisation/v3/presentation-definitions
Retrieves the presentation definition requirements associated with various OpenID Connect (OIDC) scopes.
Request
Query Parameters
- didr_write
- didr_invite
- tir_write
- tir_invite
Possible values: [openid didr_write, openid didr_invite, openid tir_write, openid tir_invite]
OIDC scope
Write to DID Registry
Example: openid didr_write
Register DID into DID Registry
Example: openid didr_invite
Write to Trusted Issuers Registry
Example: openid tir_write
Register VC into Trusted Issuers Registry
Example: openid tir_invite
Responses
- 200
- 400
- 500
Success
- application/json
- Schema
- didr_invite
- tir_invite
- didr_write
- tir_write
Schema
format object
jwt_vc object
Possible values: >= 1
jwt_vp object
Possible values: >= 1
DIDR invite
{
"id": "didr_invite_presentation",
"input_descriptors": [
{
"id": "didr_invite_credential",
"name": "Accreditation to write to the DID Registry",
"purpose": "Please present a valid VerifiableAuthorisationToOnboard issued by Root TAO or TAO",
"constraints": {
"fields": [
{
"path": [
"$.type"
],
"filter": {
"type": "array",
"contains": {
"const": "VerifiableAuthorisationToOnboard"
}
}
}
]
}
}
],
"format": {
"jwt_vc": {
"alg": [
"ES256"
]
},
"jwt_vp": {
"alg": [
"ES256"
]
}
}
}
TIR invite
{
"id": "tir_invite_presentation",
"input_descriptors": [
{
"id": "tir_invite_credential",
"name": "Accreditation to write to the Trusted Issuers Registry",
"purpose": "Please present a valid VerifiableAuthorisationForTrustChain from EBSI TO, or a Verifiable Accreditation (VerifiableAccreditationToAttest, VerifiableAccreditationToAccredit) issued by Root TAO or TAO.",
"constraints": {
"fields": [
{
"path": [
"$.type"
],
"filter": {
"type": "array",
"contains": {
"anyOf": [
{
"const": "VerifiableAuthorisationForTrustChain"
},
{
"const": "VerifiableAccreditationToAttest"
},
{
"const": "VerifiableAccreditationToAccredit"
}
]
}
}
}
]
}
}
],
"format": {
"jwt_vc": {
"alg": [
"ES256"
]
},
"jwt_vp": {
"alg": [
"ES256"
]
}
}
}
DIDR write
{
"id": "didr_write_presentation",
"name": "Any type of Verifiable Attestation",
"purpose": "Please present a valid Presentation signed by a registered Legal Entity.",
"input_descriptors": [],
"format": {
"jwt_vc": {
"alg": [
"ES256"
]
},
"jwt_vp": {
"alg": [
"ES256"
]
}
}
}
TIR write
{
"id": "tir_write_presentation",
"name": "Any type of Verifiable Attestation",
"purpose": "Please present a valid Presentation signed by a Trusted Issuer.",
"input_descriptors": [],
"format": {
"jwt_vc": {
"alg": [
"ES256"
]
},
"jwt_vp": {
"alg": [
"ES256"
]
}
}
}
Bad Request
- application/problem+json
- Schema
- Bad Request
Schema
Default value: about:blank
An absolute URI that identifies the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type.
A short summary of the problem type.
Possible values: >= 400 and <= 600
The HTTP status code generated by the origin server for this occurrence of the problem.
A human readable explanation specific to this occurrence of the problem.
An absolute URI that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"title": "Bad Request",
"status": 400,
"detail": "[\"scope must be a combination of 'openid' and one of the supported scopes ('didr_invite', 'didr_write', 'tir_invite', 'tir_write')\"]",
"type": "about:blank"
}
Internal Server Error
- application/problem+json
- Schema
- Internal Server Error
Schema
Default value: about:blank
An absolute URI that identifies the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type.
A short summary of the problem type.
Possible values: >= 400 and <= 600
The HTTP status code generated by the origin server for this occurrence of the problem.
A human readable explanation specific to this occurrence of the problem.
An absolute URI that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"title": "Internal error",
"status": 500,
"detail": "Internal error"
}