One37ID - Business Connector JS Agency API (1.0)
Download OpenAPI specification:Download
Agency API for Business Connector JS
Establish new connection by user did.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
did required | string >= 16 characters |
defaultAlias required | string non-empty |
title | string |
Responses
Request samples
- Payload
{- "did": "stringstringstri",
- "defaultAlias": "string",
- "title": "string"
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "agentId": "string",
- "contactType": 1,
- "alias": "string",
- "displayName": "string"
}
}
Establish new connection by user/business alias.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
alias required | string non-empty |
Responses
Request samples
- Payload
{- "alias": "string"
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "agentId": "string",
- "contactType": 1,
- "alias": "string",
- "displayName": "string"
}
}
Establish new connection by Out-Of-Band invitation url.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
url required | string non-empty |
Responses
Request samples
- Payload
{- "url": "string"
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "agentId": "string",
- "contactType": 1,
- "alias": "string",
- "displayName": "string"
}
}
Establish new connection by linked domain name.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
linkedDomain required | string non-empty |
defaultAlias required | string non-empty |
title | string |
Responses
Request samples
- Payload
{- "linkedDomain": "string",
- "defaultAlias": "string",
- "title": "string"
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "agentId": "string",
- "contactType": 1,
- "alias": "string",
- "displayName": "string"
}
}
Get connection list.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
id | string |
alias | string |
displayName | string |
withStageAccess | boolean |
sortOrder | string |
currentPage required | number >= 0 |
rowsPerPage required | number >= 0 |
Responses
Request samples
- Payload
{- "id": "string",
- "alias": "string",
- "displayName": "string",
- "withStageAccess": true,
- "sortOrder": "string",
- "currentPage": 0,
- "rowsPerPage": 0
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "currentPage": 1,
- "rowsPerPage": 10,
- "pagesCount": 0,
- "rowsCount": 0,
- "result": {
- "id": "string",
- "alias": "string",
- "displayName": "string",
- "withStageAccess": true,
- "createDate": "2019-08-24T14:15:22Z"
}
}
}
Delete connections by agent id's.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
id required | Array of strings |
Responses
Request samples
- Payload
{- "id": [
- "string"
]
}
Response samples
- 201
- 400
{- "isSuccessfull": true
}
Send an action message to a user by agent id.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
agentId required | string [ 1 .. 64 ] characters |
requestId | string non-empty |
expiryDate | string <date-time> |
metadata | object |
required | object (ActionMessagePayload) |
Responses
Request samples
- Payload
{- "agentId": "string",
- "requestId": "string",
- "expiryDate": "2019-08-24T14:15:22Z",
- "metadata": { },
- "payload": {
- "namespace": "string",
- "schemaName": "string",
- "schemaVersion": "string",
- "data": { },
- "buttons": [
- {
- "title": "string",
- "value": "string",
- "flow": "string"
}
], - "variables": [
- {
- "key": "string",
- "value": "string"
}
], - "sign": {
- "kid": "string",
- "publicKeyHex": "string"
}
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "workflowId": "string",
- "notification": {
- "isRequired": true,
- "payload": { }
}
}
}
Send an action message to a user by alias.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
agentAlias required | string [ 1 .. 128 ] characters |
isConnectionless | boolean Default: false |
requestId | string non-empty |
expiryDate | string <date-time> |
metadata | object |
required | object (ActionMessagePayload) |
Responses
Request samples
- Payload
This is an example of simple action message with two buttons.
{- "agentAlias": "default:ap1",
- "isConnectionless": false,
- "metadata": {
- "ip": "192.168.0.1",
- "bfphash": "trusted_browser_hash"
}, - "payload": {
- "schemaName": "action.signup.approve",
- "schemaVersion": "1.0",
- "namespace": "approve_access",
- "buttons": [
- {
- "title": "Approve",
- "value": "yes"
}, - {
- "title": "Reject",
- "value": "no"
}
], - "data": {
- "title": "Approve user access to the portal to complete the sign-up process.",
- "user": {
- "firstName": "Rahul",
- "lastName": "Bodapati"
}
}
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "workflowId": "string",
- "notification": {
- "isRequired": true,
- "payload": { }
}, - "isWaitingOnConnection": true
}
}
Send a custom message to a user by agent id.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
agentId required | string [ 1 .. 64 ] characters |
required | object (CustomMessagePayload) |
Responses
Request samples
- Payload
{- "agentId": "string",
- "payload": {
- "namespace": "string",
- "data": { }
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "workflowId": "string",
- "notification": {
- "isRequired": true,
- "payload": { }
}
}
}
Send a custom message to a user by alias.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
agentAlias required | string [ 1 .. 128 ] characters |
isConnectionless | boolean Default: false |
required | object (CustomMessagePayload) |
Responses
Request samples
- Payload
This is an example of a simple message with a couple of fields in payload.
{- "agentAlias": "default:ap1",
- "isConnectionless": false,
- "payload": {
- "namespace": "message.payment.confirmation",
- "data": {
- "paymentNumber": "abc-123456",
- "amount": 1235,
- "ccy": "USD",
- "status": "sent"
}
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "workflowId": "string",
- "notification": {
- "isRequired": true,
- "payload": { }
}, - "isWaitingOnConnection": true
}
}
Send a data message to a user by agent id.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
agentId required | string [ 1 .. 64 ] characters |
requestId required | string non-empty |
required | object (DataMessagePayload) |
Responses
Request samples
- Payload
{- "agentId": "string",
- "requestId": "string",
- "payload": {
- "url": "string",
- "data": "string"
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "workflowId": "string",
- "notification": {
- "isRequired": true,
- "payload": { }
}
}
}
Send a data message to a user by alias.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
agentAlias required | string [ 1 .. 128 ] characters |
requestId required | string non-empty |
required | object (DataMessagePayload) |
Responses
Request samples
- Payload
{- "agentAlias": "string",
- "requestId": "string",
- "payload": {
- "url": "string",
- "data": "string"
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "workflowId": "string",
- "notification": {
- "isRequired": true,
- "payload": { }
}, - "isWaitingOnConnection": true
}
}
Send a general message to a user by agent id.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
agentId required | string [ 1 .. 64 ] characters |
required | object (GeneralMessagePayload) |
Responses
Request samples
- Payload
{- "agentId": "string",
- "payload": {
- "message": "string",
- "additionalInformation": "string",
- "statusCode": "string"
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "workflowId": "string",
- "notification": {
- "isRequired": true,
- "payload": { }
}
}
}
Send a general message to a user by alias.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
agentAlias required | string [ 1 .. 128 ] characters |
isConnectionless | boolean Default: false |
required | object (GeneralMessagePayload) |
Responses
Request samples
- Payload
This is an example of simple message with title and description.
{- "agentAlias": "default:ap1",
- "isConnectionless": false,
- "payload": {
- "message": "Verification process.",
- "additionalInformation": "Verification successfully completed."
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "workflowId": "string",
- "notification": {
- "isRequired": true,
- "payload": { }
}, - "isWaitingOnConnection": true
}
}
Send a system message to a user by agent id.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
agentId required | string [ 1 .. 64 ] characters |
required | object (SystemMessagePayload) |
Responses
Request samples
- Payload
{- "agentId": "string",
- "payload": {
- "type": "string",
- "data": { },
- "correlationId": "string"
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "workflowId": "string",
- "notification": {
- "isRequired": true,
- "payload": { }
}
}
}
Send a system message to a user by alias.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
agentAlias required | string [ 1 .. 128 ] characters |
required | object (SystemMessagePayload) |
Responses
Request samples
- Payload
{- "agentAlias": "string",
- "payload": {
- "type": "string",
- "data": { },
- "correlationId": "string"
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "workflowId": "string",
- "notification": {
- "isRequired": true,
- "payload": { }
}, - "isWaitingOnConnection": true
}
}
Initiate a workflow on other Agent by agent id.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
agentId required | string [ 1 .. 64 ] characters |
required | object (InitWorkflowMessagePayload) |
Responses
Request samples
- Payload
{- "agentId": "string",
- "payload": {
- "url": "string",
- "data": { }
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "workflowId": "string",
- "notification": {
- "isRequired": true,
- "payload": { }
}
}
}
Initiate a workflow on other Agent by alias.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
agentAlias required | string [ 1 .. 128 ] characters |
required | object (InitWorkflowMessagePayload) |
Responses
Request samples
- Payload
{- "agentAlias": "string",
- "payload": {
- "url": "string",
- "data": { }
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "workflowId": "string",
- "notification": {
- "isRequired": true,
- "payload": { }
}, - "isWaitingOnConnection": true
}
}
Issue a credential to a user by agent id.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
agentId required | string = 36 characters |
requestId | string non-empty |
expiryDate | string <date-time> |
required | Array of objects (IssueCredentialPayload) |
Responses
Request samples
- Payload
{- "agentId": "stringstringstringstringstringstring",
- "requestId": "string",
- "expiryDate": "2019-08-24T14:15:22Z",
- "payload": [
- {
- "schemaId": "string",
- "expirationDate": "2019-08-24T14:15:22Z",
- "format": "w3c",
- "attributes": [
- {
- "key": "string",
- "value": { },
- "namespace": "string"
}
]
}
]
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "workflowId": "string",
- "credentials": [
- {
- "credentialId": "string",
- "schemaId": "string",
- "namespace": "string"
}
], - "notification": {
- "isRequired": true,
- "payload": { }
}
}
}
Issue a credential to a user by alias.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
agentAlias required | string [ 1 .. 128 ] characters |
requestId | string non-empty |
expiryDate | string <date-time> |
required | Array of objects (IssueCredentialPayload) |
Responses
Request samples
- Payload
This is an example of issuing a verified email W3C credential.
{- "agentAlias": "default:ap1",
- "payload": [
- {
- "format": "w3c",
- "attributes": [
- {
- "key": "_label",
- "value": "Verified Email"
}, - {
- "key": "_namespace",
- "value": "personal.contact.verifiedemail"
}, - {
- "key": "_type",
- "value": "Email"
}, - {
- "key": "_category",
- "value": "ContactInformation"
}, - {
- "key": "_trustlevel",
- "value": "2"
}, - {
- "key": "email",
- "value": "test@sample.com"
}
]
}
]
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "workflowId": "string",
- "credentials": [
- {
- "credentialId": "string",
- "schemaId": "string",
- "namespace": "string"
}
], - "notification": {
- "isRequired": true,
- "payload": { }
}, - "isWaitingOnConnection": true
}
}
Build connectionless credential offer.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
requestId | string non-empty |
expiryDate | string <date-time> |
required | Array of objects (IssueCredentialPayload) |
Responses
Request samples
- Payload
{- "requestId": "string",
- "expiryDate": "2019-08-24T14:15:22Z",
- "payload": [
- {
- "schemaId": "string",
- "expirationDate": "2019-08-24T14:15:22Z",
- "format": "w3c",
- "attributes": [
- {
- "key": "string",
- "value": { },
- "namespace": "string"
}
]
}
]
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "workflowId": "string",
- "url": "string"
}
}
Build connectionless credential offer as QR code image.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
requestId | string non-empty |
expiryDate | string <date-time> |
required | Array of objects (IssueCredentialPayload) |
Responses
Request samples
- Payload
{- "requestId": "string",
- "expiryDate": "2019-08-24T14:15:22Z",
- "payload": [
- {
- "schemaId": "string",
- "expirationDate": "2019-08-24T14:15:22Z",
- "format": "w3c",
- "attributes": [
- {
- "key": "string",
- "value": { },
- "namespace": "string"
}
]
}
]
}
Response samples
- 400
{- "isSuccessfull": true,
- "errorCode": 0,
- "message": "string"
}
Get credential list.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
dateFrom | string <date-time> |
dateTo | string <date-time> |
sortOrder | string |
currentPage required | number >= 0 |
rowsPerPage required | number >= 0 |
Responses
Request samples
- Payload
{- "dateFrom": "2019-08-24T14:15:22Z",
- "dateTo": "2019-08-24T14:15:22Z",
- "sortOrder": "string",
- "currentPage": 0,
- "rowsPerPage": 0
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "currentPage": 1,
- "rowsPerPage": 10,
- "pagesCount": 0,
- "rowsCount": 0,
- "result": {
- "id": "string",
- "createDateTime": "2019-08-24T14:15:22Z",
- "schemaId": "string",
- "schemaName": "string",
- "schemaVersion": "string",
- "issuer": {
- "agentId": "string",
- "contactType": 1,
- "alias": "string",
- "displayName": "string"
}
}
}
}
Get credential details.
path Parameters
id required | string |
header Parameters
hash required | string Secret key |
Responses
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "id": "string",
- "createDateTime": "2019-08-24T14:15:22Z",
- "schemaId": "string",
- "schemaName": "string",
- "schemaVersion": "string",
- "issuer": {
- "agentId": "string",
- "contactType": 1,
- "alias": "string",
- "displayName": "string"
}, - "attributes": { }
}
}
Check is credential revoked or suspended.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
purpose required | string Enum: "revocation" "suspension" Status list purpose. |
id required | string >= 36 characters |
Responses
Request samples
- Payload
{- "purpose": "revocation",
- "id": "stringstringstringstringstringstring"
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": true
}
Revoke a credential by adding it to the Revocation List.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
purpose required | string Enum: "revocation" "suspension" Status list purpose. |
isNotifyHolder | boolean Default: false |
id required | Array of strings |
Responses
Request samples
- Payload
{- "purpose": "revocation",
- "isNotifyHolder": false,
- "id": [
- "string"
]
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": 0
}
Revoke all credentials that meet specified criteria by adding them to the Revocation List.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
purpose required | string Enum: "revocation" "suspension" Status list purpose. |
isNotifyHolder | boolean Default: false |
schemaId | string |
required | Array of objects (IssuedCredentialAttributeRequest) |
Responses
Request samples
- Payload
{- "purpose": "revocation",
- "isNotifyHolder": false,
- "schemaId": "string",
- "attributes": [
- {
- "name": "string",
- "value": "string"
}
]
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": 0
}
Unrevoke a credential by removing it from the Revocation List.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
purpose required | string Enum: "revocation" "suspension" Status list purpose. |
isNotifyHolder | boolean Default: false |
id required | Array of strings |
Responses
Request samples
- Payload
{- "purpose": "revocation",
- "isNotifyHolder": false,
- "id": [
- "string"
]
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": 0
}
Restore all credentials matching specified criteria by removing them from the Revocation List.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
purpose required | string Enum: "revocation" "suspension" Status list purpose. |
isNotifyHolder | boolean Default: false |
schemaId | string |
required | Array of objects (IssuedCredentialAttributeRequest) |
Responses
Request samples
- Payload
{- "purpose": "revocation",
- "isNotifyHolder": false,
- "schemaId": "string",
- "attributes": [
- {
- "name": "string",
- "value": "string"
}
]
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": 0
}
Get credential offer list.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
dateFrom | string <date-time> |
dateTo | string <date-time> |
sortOrder | string |
currentPage required | number >= 0 |
rowsPerPage required | number >= 0 |
Responses
Request samples
- Payload
{- "dateFrom": "2019-08-24T14:15:22Z",
- "dateTo": "2019-08-24T14:15:22Z",
- "sortOrder": "string",
- "currentPage": 0,
- "rowsPerPage": 0
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "currentPage": 1,
- "rowsPerPage": 10,
- "pagesCount": 0,
- "rowsCount": 0,
- "result": {
- "id": "string",
- "createDateTime": "2019-08-24T14:15:22Z",
- "schemaId": "string",
- "schemaName": "string",
- "schemaVersion": "string",
- "issuer": {
- "agentId": "string",
- "contactType": 1,
- "alias": "string",
- "displayName": "string"
}
}
}
}
Get credential offer details.
path Parameters
id required | string |
header Parameters
hash required | string Secret key |
Responses
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "id": "string",
- "createDateTime": "2019-08-24T14:15:22Z",
- "schemaId": "string",
- "schemaName": "string",
- "schemaVersion": "string",
- "issuer": {
- "agentId": "string",
- "contactType": 1,
- "alias": "string",
- "displayName": "string"
}, - "attributes": { }
}
}
Send proof request to a user by id.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
agentId required | string = 36 characters |
requestId | string non-empty |
protocol | string Default: "oid4vp" Enum: "oid4vp" "didcomm" |
expiryDate | string <date-time> |
metadata | object |
required | object (ProofRequestPayload) |
Responses
Request samples
- Payload
{- "agentId": "stringstringstringstringstringstring",
- "requestId": "string",
- "protocol": "oid4vp",
- "expiryDate": "2019-08-24T14:15:22Z",
- "metadata": { },
- "payload": {
- "name": "string",
- "goalCode": "string",
- "biometric": "none",
- "uiTemplate": {
- "namespace": "string",
- "version": 0
}, - "credentials": [
- {
- "format": "w3c",
- "name": "string",
- "goalCode": "string",
- "localizationKey": "string",
- "restrictions": {
- "schemaId": "string",
- "issuerDid": "string",
- "attributes": [
- {
- "key": "string",
- "value": { },
- "namespace": "string"
}
]
}, - "attributes": [
- {
- "namespace": "string",
- "name": "string",
- "isRequired": true
}
]
}
]
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "workflowId": "string",
- "notification": {
- "isRequired": true,
- "payload": { }
}
}
}
Send proof request to a user by alias.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
agentAlias required | string [ 1 .. 128 ] characters |
requestId | string non-empty |
protocol | string Default: "oid4vp" Enum: "oid4vp" "didcomm" |
expiryDate | string <date-time> |
metadata | object |
required | object (ProofRequestPayload) |
Responses
Request samples
- Payload
This is an example of presentation request of verified email as W3C credential.
{- "agentAlias": "default:ap1",
- "protocol": "oid4vp",
- "metadata": {
- "ip": "192.168.0.1",
- "bfphash": "trusted_browser_hash"
}, - "payload": {
- "name": "Provide email to complete flow.",
- "goalCode": "verify.email",
- "credentials": [
- {
- "format": "w3c",
- "name": "W3C Verified Email",
- "goalCode": "email",
- "restrictions": {
- "attributes": [
- {
- "key": "_namespace",
- "value": "personal.contact.verifiedemail"
}
]
}, - "attributes": [
- {
- "name": "email",
- "isRequired": true
}
]
}
]
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "workflowId": "string",
- "notification": {
- "isRequired": true,
- "payload": { }
}, - "isWaitingOnConnection": true
}
}
Build connectionless proof request.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
requestId | string non-empty |
protocol | string Default: "oid4vp" Enum: "oid4vp" "didcomm" |
expiryDate | string <date-time> |
metadata | object |
required | object (ProofRequestPayload) |
Responses
Request samples
- Payload
{- "requestId": "string",
- "protocol": "oid4vp",
- "expiryDate": "2019-08-24T14:15:22Z",
- "metadata": { },
- "payload": {
- "name": "string",
- "goalCode": "string",
- "biometric": "none",
- "uiTemplate": {
- "namespace": "string",
- "version": 0
}, - "credentials": [
- {
- "format": "w3c",
- "name": "string",
- "goalCode": "string",
- "localizationKey": "string",
- "restrictions": {
- "schemaId": "string",
- "issuerDid": "string",
- "attributes": [
- {
- "key": "string",
- "value": { },
- "namespace": "string"
}
]
}, - "attributes": [
- {
- "namespace": "string",
- "name": "string",
- "isRequired": true
}
]
}
]
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "workflowId": "string",
- "url": "string"
}
}
Build connectionless proof request as QR code image.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
requestId | string non-empty |
protocol | string Default: "oid4vp" Enum: "oid4vp" "didcomm" |
expiryDate | string <date-time> |
metadata | object |
required | object (ProofRequestPayload) |
Responses
Request samples
- Payload
{- "requestId": "string",
- "protocol": "oid4vp",
- "expiryDate": "2019-08-24T14:15:22Z",
- "metadata": { },
- "payload": {
- "name": "string",
- "goalCode": "string",
- "biometric": "none",
- "uiTemplate": {
- "namespace": "string",
- "version": 0
}, - "credentials": [
- {
- "format": "w3c",
- "name": "string",
- "goalCode": "string",
- "localizationKey": "string",
- "restrictions": {
- "schemaId": "string",
- "issuerDid": "string",
- "attributes": [
- {
- "key": "string",
- "value": { },
- "namespace": "string"
}
]
}, - "attributes": [
- {
- "namespace": "string",
- "name": "string",
- "isRequired": true
}
]
}
]
}
}
Response samples
- 400
{- "isSuccessfull": true,
- "errorCode": 0,
- "message": "string"
}
Get url to start flow.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
workflow required | string non-empty |
methodName | string non-empty |
isConnectionRequired | boolean |
expiryDate | string <date-time> |
goalCode | string |
goal | string |
parameters | object |
Responses
Request samples
- Payload
{- "workflow": "string",
- "methodName": "string",
- "isConnectionRequired": true,
- "expiryDate": "2019-08-24T14:15:22Z",
- "goalCode": "string",
- "goal": "string",
- "parameters": { }
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": "string"
}
Get url as QR code image to start flow.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
workflow required | string non-empty |
methodName | string non-empty |
isConnectionRequired | boolean |
expiryDate | string <date-time> |
goalCode | string |
goal | string |
parameters | object |
Responses
Request samples
- Payload
{- "workflow": "string",
- "methodName": "string",
- "isConnectionRequired": true,
- "expiryDate": "2019-08-24T14:15:22Z",
- "goalCode": "string",
- "goal": "string",
- "parameters": { }
}
Response samples
- 400
{- "isSuccessfull": true,
- "errorCode": 0,
- "message": "string"
}
Start new flow using embedded BE Engine.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
workflowName required | string non-empty |
workflowVersion | string |
payload | object |
Responses
Request samples
- Payload
{- "workflowName": "string",
- "workflowVersion": "string",
- "payload": { }
}
Response samples
- 201
- 400
{- "isSuccessfull": true
}
Resume flow by correlation id on BE Workflow Engine.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
correlationId required | string non-empty |
payload | object |
Responses
Request samples
- Payload
{- "correlationId": "string",
- "payload": { }
}
Response samples
- 201
- 400
{- "isSuccessfull": true
}
Resume specific flow on BE Workflow Engine.
path Parameters
instanceId required | string Flow instance identifier. |
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
invocationPoint required | string |
payload | object |
Responses
Request samples
- Payload
{- "invocationPoint": "string",
- "payload": { }
}
Response samples
- 201
- 400
{- "isSuccessfull": true
}
Create a new metric event.
Request Body schema: application/jsonrequired
Id | string |
Job required | string |
MetricName required | string |
MetricValue required | number |
Unit required | string |
ContactIdentifier | string |
Tag | string |
Tags | Array of strings |
Created | string <date-time> Default: "2024-11-18T13:07:45.669Z" |
Responses
Request samples
- Payload
{- "Id": "string",
- "Job": "string",
- "MetricName": "string",
- "MetricValue": 0,
- "Unit": "string",
- "ContactIdentifier": "string",
- "Tag": "string",
- "Tags": [
- "string"
], - "Created": "2024-11-18T13:07:45.669Z"
}
Get alias details.
path Parameters
aliasKey required | string |
header Parameters
hash required | string Secret key |
Responses
Response samples
- 200
- 400
{- "isSuccessfull": true,
- "result": {
- "aliasKey": "string",
- "alias": "string",
- "displayName": "string",
- "isVerified": true,
- "isDefault": true,
- "defaultAlias": "string",
- "type": "string"
}
}
Create alias in ARS.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
agentId required | string = 36 characters |
isOverride required | boolean Default: false |
required | object (CreateAliasPayloadRequest) |
Responses
Request samples
- Payload
{- "agentId": "stringstringstringstringstringstring",
- "isOverride": false,
- "payload": {
- "source": "mobile",
- "alias": "string",
- "aliasValue": "string",
- "displayName": "string",
- "ownerId": "string",
- "isVerified": true,
- "isEnabled": true
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "aliasKey": "string",
- "alias": "string",
- "type": "default",
- "displayName": "string",
- "isEnabled": true,
- "isVerified": true,
- "createDate": "2019-08-24T14:15:22Z",
- "expiryDate": "2019-08-24T14:15:22Z"
}
}
Sign-in to Business with alias or QR code.
Request Body schema: application/jsonrequired
contactId required | string = 36 characters |
alias | string |
sessionId | string |
metadata | object |
Responses
Request samples
- Payload
{- "contactId": "stringstringstringstringstringstring",
- "alias": "string",
- "sessionId": "string",
- "metadata": { }
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "sessionId": "string",
- "url": "string"
}
}
Sign-up to Business with alias or QR code.
Request Body schema: application/jsonrequired
alias | string |
metadata | object |
Responses
Request samples
- Payload
{- "alias": "string",
- "metadata": { }
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "sessionId": "string",
- "url": "string"
}
}
Complete sign-in process to Business.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
isSuccessful required | boolean |
message | string |
sessionId required | string |
email required | string |
Responses
Request samples
- Payload
{- "isSuccessful": true,
- "message": "string",
- "sessionId": "string",
- "email": "string"
}
Response samples
- 201
- 400
{- "isSuccessfull": true
}
Complete sign-up process to Business.
header Parameters
hash required | string Secret key |
Request Body schema: application/jsonrequired
isSuccessful required | boolean |
message | string |
agentId required | string |
signupType required | number Enum: 0 1 2 |
inviteId | string |
assignedByUserId | string |
required | object (BusinessSignUpCompletePayloadRequest) |
Responses
Request samples
- Payload
{- "isSuccessful": true,
- "message": "string",
- "agentId": "string",
- "signupType": 0,
- "inviteId": "string",
- "assignedByUserId": "string",
- "payload": {
- "email": "string",
- "fullName": "string",
- "identifier": "string"
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true
}
Get a list of aliases.
Authorizations:
Request Body schema: application/jsonrequired
id | string |
displayName | string |
state | Array of numbers Items Enum: 1 2 3 |
sortOrder | string |
currentPage required | number >= 0 |
rowsPerPage required | number >= 0 |
Responses
Request samples
- Payload
{- "id": "string",
- "displayName": "string",
- "state": [
- 1
], - "sortOrder": "string",
- "currentPage": 0,
- "rowsPerPage": 0
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "currentPage": 1,
- "rowsPerPage": 10,
- "pagesCount": 0,
- "rowsCount": 0,
- "result": {
- "id": "string",
- "displayName": "string",
- "state": 1,
- "aliasName": "string",
- "type": "default",
- "isDefault": true,
- "isAutoGenerated": true,
- "expiryDate": "2019-08-24T14:15:22Z",
- "aliasAction": {
- "id": "string",
- "type": 1,
- "createDate": 1,
- "expiryDate": "2019-08-24T14:15:22Z"
}
}
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "id": "string",
- "aliasName": "string",
- "displayName": "string",
- "state": 1,
- "type": "default",
- "isDefault": true,
- "expiryDate": "2019-08-24T14:15:22Z",
- "createDate": "2019-08-24T14:15:22Z",
- "updateDate": "2019-08-24T14:15:22Z",
- "createdByUserId": "string",
- "updatedByUserId": "string",
- "aliasAction": {
- "id": "string",
- "type": 1,
- "createDate": 1,
- "expiryDate": "2019-08-24T14:15:22Z"
}
}
}
Create a new Alias
Authorizations:
Request Body schema: application/jsonrequired
id required | string <= 255 characters |
displayName | string <= 128 characters |
Responses
Request samples
- Payload
{- "id": "string",
- "displayName": "string"
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "id": "string",
- "aliasName": "string",
- "displayName": "string",
- "state": 1,
- "type": "default",
- "isDefault": true,
- "expiryDate": "2019-08-24T14:15:22Z",
- "createDate": "2019-08-24T14:15:22Z",
- "updateDate": "2019-08-24T14:15:22Z",
- "createdByUserId": "string",
- "updatedByUserId": "string",
- "aliasAction": {
- "id": "string",
- "type": 1,
- "createDate": 1,
- "expiryDate": "2019-08-24T14:15:22Z"
}
}
}
Get a list of aliases.
Authorizations:
Request Body schema: application/jsonrequired
id | string |
displayName | string |
state | Array of numbers Items Enum: 1 2 3 |
sortOrder | string |
currentPage required | number >= 0 |
rowsPerPage required | number >= 0 |
Responses
Request samples
- Payload
{- "id": "string",
- "displayName": "string",
- "state": [
- 1
], - "sortOrder": "string",
- "currentPage": 0,
- "rowsPerPage": 0
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "currentPage": 1,
- "rowsPerPage": 10,
- "pagesCount": 0,
- "rowsCount": 0,
- "result": {
- "id": "string",
- "displayName": "string",
- "state": 1,
- "aliasName": "string",
- "type": "default",
- "isDefault": true,
- "isAutoGenerated": true,
- "expiryDate": "2019-08-24T14:15:22Z",
- "aliasAction": {
- "id": "string",
- "type": 1,
- "createDate": 1,
- "expiryDate": "2019-08-24T14:15:22Z"
}
}
}
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "id": "string",
- "aliasName": "string",
- "displayName": "string",
- "state": 1,
- "type": "default",
- "isDefault": true,
- "expiryDate": "2019-08-24T14:15:22Z",
- "createDate": "2019-08-24T14:15:22Z",
- "updateDate": "2019-08-24T14:15:22Z",
- "createdByUserId": "string",
- "updatedByUserId": "string",
- "aliasAction": {
- "id": "string",
- "type": 1,
- "createDate": 1,
- "expiryDate": "2019-08-24T14:15:22Z"
}
}
}
Create a new Alias
Authorizations:
Request Body schema: application/jsonrequired
id required | string <= 255 characters |
displayName | string <= 128 characters |
Responses
Request samples
- Payload
{- "id": "string",
- "displayName": "string"
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "id": "string",
- "aliasName": "string",
- "displayName": "string",
- "state": 1,
- "type": "default",
- "isDefault": true,
- "expiryDate": "2019-08-24T14:15:22Z",
- "createDate": "2019-08-24T14:15:22Z",
- "updateDate": "2019-08-24T14:15:22Z",
- "createdByUserId": "string",
- "updatedByUserId": "string",
- "aliasAction": {
- "id": "string",
- "type": 1,
- "createDate": 1,
- "expiryDate": "2019-08-24T14:15:22Z"
}
}
}
Create new invite for user to join a Business.
Authorizations:
Request Body schema: application/jsonrequired
alias required | string non-empty |
roles required | Array of strings |
Responses
Request samples
- Payload
{- "alias": "string",
- "roles": [
- "string"
]
}
Response samples
- 201
- 400
{- "isSuccessfull": true,
- "result": {
- "id": "string",
- "alias": "string",
- "createDate": "2019-08-24T14:15:22Z",
- "lastInviteDate": "2019-08-24T14:15:22Z",
- "attemptCount": 0,
- "roles": [
- {
- "id": "string",
- "name": "string"
}
]
}
}