Skip to main content

Verifiable Credentials

MX provides Verifiable Credential endpoints that comply with web5 standards.

MX DID: did:dht:kfcakjzahwimgo9zzjw6yknt9srdtkmfqbeybekcg3xzz1ztg95y

MX formats the data and inserts it into the Verifiable Credential format and signs the data into a JWT with our private key which is stored on MX systems. The public key can be resolved from MX's did on DHT to verify the signature of the JWT.

The beta header is required: application/vnd.mx.api.v2beta+json

A VC is returned as a JWT in the response. Decode the JWT to read the data. All data is in FDX v5.3 standardized data format.

Example account data​


_108
{
_108
"vc": {
_108
"@context": [
_108
"https://www.w3.org/2018/credentials/v1"
_108
],
_108
"id": "https://api.test.test.mx/vc/users/USR-3ea736e24-edd6-4417-9b5-dee48cc3125b/members/MBR-c4985cbf-63d9-145f-87272-e4e41ccf3b6/accounts",
_108
"type": [
_108
"VerifiableCredential",
_108
"FinancialAccountCredential"
_108
],
_108
"issuer": "did:dht:sa7cseh7jcz51wj6fj13dw7jyg44ejwcdf8iqxbooj41ipeg76eo",
_108
"issuanceDate": "2024-03-01T18:42:19Z",
_108
"credentialSubject": {
_108
"accounts": [
_108
{
_108
"locAccount": {
_108
"accountId": "ACT-848-57d0-4a24-a0c1-e72ad24a0126096bd",
_108
"accountType": "CREDITCARD",
_108
"accountNumber": "324453974",
_108
"accountNumberDisplay": "****5344",
_108
"productName": null,
_108
"nickname": null,
_108
"status": "OPEN",
_108
"accountOpenDate": "2022-07-11T15:40:40Z",
_108
"accountClosedDate": null,
_108
"currency": {
_108
"currencyRate": null,
_108
"currencyCode": null,
_108
"originalCurrencyCode": null
_108
},
_108
"fiAttributes": [
_108
{
_108
"name": "member_guid",
_108
"value": "MBR-f1a3285d-63d9-498f-8772-8ae775c0e0e9"
_108
},
_108
{
_108
"name": "institution_guid",
_108
"value": "INS-f7e87eff-e855-b68f-68a7-e5192784ccb6"
_108
},
_108
{
_108
"name": "external_guid",
_108
"value": "account-cc5145bf-06c0-46a1-b800-3ef3241621a9"
_108
}
_108
],
_108
"routingTransitNumber": null,
_108
"balanceType": "LIABILITY",
_108
"interestRate": null,
_108
"lastActivityDate": "2022-07-11T15:40:40Z",
_108
"balanceAsOf": "2022-07-11T15:40:40Z",
_108
"creditLine": null,
_108
"availableCredit": 13000,
_108
"nextPaymentDate": null,
_108
"principalBalance": null,
_108
"currentBalance": 1000,
_108
"minimumPaymentAmount": null,
_108
"purchasesApr": null
_108
}
_108
},
_108
{
_108
"depositAccount": {
_108
"accountId": "ACT-96f3fdas3-1e05-4a4b-9fd5-571f32fdad95c",
_108
"accountType": "CHECKING",
_108
"accountNumber": "898735161",
_108
"accountNumberDisplay": "****5161",
_108
"productName": null,
_108
"nickname": null,
_108
"status": "OPEN",
_108
"accountOpenDate": "2022-07-11T15:40:40Z",
_108
"accountClosedDate": null,
_108
"currency": {
_108
"currencyRate": null,
_108
"currencyCode": null,
_108
"originalCurrencyCode": null
_108
},
_108
"fiAttributes": [
_108
{
_108
"name": "member_guid",
_108
"value": "MBR-cc5dsa5f-63d9-498f-8772-e4ey9841ccb6"
_108
},
_108
{
_108
"name": "institution_guid",
_108
"value": "INS-f1r5685d-e855-p98f-6aa7-8eu8470e0e9"
_108
},
_108
{
_108
"name": "external_guid",
_108
"value": "account-c6e98564-8860-0000-9d85-650dsd8fjusfe" }
_108
],
_108
"routingTransitNumber": null,
_108
"balanceType": "ASSET",
_108
"interestRate": null,
_108
"lastActivityDate": "2022-07-11T15:40:40Z",
_108
"balanceAsOf": "2022-07-11T15:40:40Z",
_108
"currentBalance": 1000,
_108
"openingDayBalance": null,
_108
"availableBalance": 1000,
_108
"annualPercentageYield": null,
_108
"maturityDate": null
_108
}
_108
},
_108
],
_108
"id": "USR-3a7cc3e1-edd6-b317-9f65-d6e84224ee5b"
_108
}
_108
},
_108
"iss": "did:dht:sa713ddf8jcz51w7jbooj41iiqcseh7pegyg44ejwcwj6fjx76eo",
_108
"iat": 1709318539,
_108
"jti": "https://api.sand.internal.mx/vc/users/USR-3e3a7cc1-edd6-4417-9b35-48dee6e2425b/members/MBR-c4c515bf-63d9-498f-8772-e1cc4ef324b6/accounts",
_108
"sub": "USR-3ccea731-edd6-4417-9b35-84dee6e2425b"
_108
}

On this page