Authorization
Handles the creation of an authorization request. Creates a new authorization request with the provided presentation definition.
Request body for creating an authorization request
Redirect URI to which the response will be sent
http://example.com
Validity of the authorization request in seconds
600
POST /v1/verifier/authorization-requests HTTP/1.1
Host: api
x-client-secret: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 208
{
"redirect_uri": "http://example.com",
"presentation_definition": {
"input_descriptors": [
{
"constraints": {
"fields": [
"[Circular Reference]"
],
"limit_disclosure": "required"
},
"id": "text"
}
],
"id": "text"
},
"validity": 600
}
{
"request_uri": "http://127.0.0.1:9004/api/v1/verifier/authorization-request/a0b2e682-d92f-4767-a83a-d60d196da792",
"qr_code_url": "http://127.0.0.1:9004/api/v1/verifier/qr-code/a0b2e682-d92f-4767-a83a-d60d196da792",
"state": "abcdef12345678901234567890abcdef",
"nonce": "1234567890abcdef1234567890abcdef",
"validity": 600
}
Retrieves an authorization request by ID. Returns the details of the specified authorization request.
GET /v1/verifier/authorization-requests/{id} HTTP/1.1
Host: api
Accept: */*
{
"id": "text",
"state": "text",
"nonce": "text",
"redirect_uri": "text",
"validity": 1,
"response_uri": "text",
"presentation_definition": {
"input_descriptors": [
{
"constraints": {
"fields": [
"[Circular Reference]"
],
"limit_disclosure": "required"
},
"id": "text"
}
],
"id": "text"
},
"used": false
}
Handles the deletion of an authorization request by ID. Removes the specified authorization request from the system.
DELETE /v1/verifier/authorization-requests/{id} HTTP/1.1
Host: api
x-client-secret: YOUR_API_KEY
Accept: */*
No content
Handler for the 'submit-vp' endpoint. Processes a submitted verifiable presentation, validates it against the presentation definition, and sends the verification result to the redirect URI.
Request body for submitting a verifiable presentation
Random string to prevent CSRF attacks
abcdef12345678901234567890abcdef
Random string to ensure request uniqueness
1234567890abcdef1234567890abcdef
POST /v1/verifier/verifiable-presentations HTTP/1.1
Host: api
Content-Type: application/json
Accept: */*
Content-Length: 1265
{
"vp_token": {
"proof": {
"challange": "text",
"nonce": "text",
"jws": "text",
"proofValue": "text",
"proofPurpose": "assertionMethod",
"verificationMethod": "text",
"created": "text",
"type": "EcdsaSecp256k1Signature2019"
},
"holder": "text",
"id": "text",
"verifiableCredential": [
{
"evidence": {},
"credentialStatus": [
{
"id": "text",
"type": "BitstringStatusListEntry",
"statusPurpose": "refresh",
"statusListIndex": 1,
"statusListCredential": "text",
"statusSize": 1,
"statusMessage": [
{
"message": "text",
"status": "text",
"ANY_ADDITIONAL_PROPERTY": "anything"
}
]
}
],
"credentialSchema": {
"type": "JsonSchemaValidator2018",
"id": "text"
},
"expirationDate": "text",
"proof": {
"challange": "text",
"nonce": "text",
"jws": "text",
"proofValue": "text",
"proofPurpose": "assertionMethod",
"verificationMethod": "text",
"created": "text",
"type": "EcdsaSecp256k1Signature2019"
},
"credentialSubject": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"issuanceDate": "text",
"issuer": {
"name": "text",
"id": "text"
},
"id": "text",
"type": [
"text"
],
"@context": [
"text"
]
}
],
"type": "text",
"@context": [
"text"
]
},
"presentation_submission": {
"descriptor_map": [
{
"path_nested": {
"format": "text",
"path": "text"
},
"format": "text",
"path": "text",
"id": "text"
}
],
"definition_id": "text",
"id": "text"
},
"state": "abcdef12345678901234567890abcdef",
"nonce": "1234567890abcdef1234567890abcdef"
}
{
"message": "text"
}