Get your vaspDID

What is a DID?

A DID is a W3C standard and is defined as a new type of identifier that enables verifiable, decentralised digital identity. A DID refers to any subject (e.g., a person, organization, thing, data model, abstract entity, etc.) as determined by the controller of the DID. You can read more about this here.

❗️

To perform most of the API requests, you will have to know what the DID of your VASP is.

---

While generating the API credentials

When you get your client ID and secret to generate the accessToken, you will also see your VASP DID:

---

Finding a DID using the API

If you don't already have your vaspDID, you can call:

JSON

TEST: GET https://api.notabene.dev/auth/viewer
PROD: GET https://api.notabene.id/auth/viewer

with the accessToken that you generated in the previous step to see information about the authenticated user: "role, jobTitle", name, email, vasps, role-permissions"

In "vasps" you will see the DID(s) of the VASP(s) that you have access to:

Response

{
    "did": "did:ethr:0xefbb14b73473ccfd610543af4b1c8fda027c57bf", <-- this is your user's DID
    "fields": [
        {
            "fieldName": "role",
            "values": [
                {
                    "value": "admin",
                    "issuer": "did:ethr:0xc9dc97121e4d0ab0ec2b569c3a16858f5e309ef0",
                    "issuanceDate": "2022-04-05T08:11:56.000Z",
                    "expirationDate": null
                },
            ]
        },
        {
            "fieldName": "jobTitle",
            "values": [
                {
                    "value": "Solution Wizard",
                    "issuer": "did:ethr:0xefbb14b73473ccfd610543af4b1c8fda027c57bf",
                    "issuanceDate": "2022-04-04T10:04:37.000Z",
                    "expirationDate": null
                }
            ]
        },
        {
            "fieldName": "name",
            "values": [
                {
                    "value": "Christoffer Nilsvik",
                    "issuer": "did:ethr:0xefbb14b73473ccfd610543af4b1c8fda027c57bf",
                    "issuanceDate": "2022-04-04T10:04:37.000Z",
                    "expirationDate": null
                }
            ]
        },
        {
            "fieldName": "email",
            "values": [
                {
                    "value": "[email protected]",
                    "issuer": "did:ethr:0xefbb14b73473ccfd610543af4b1c8fda027c57bf",
                    "issuanceDate": "2022-02-09T11:09:29.000Z",
                    "expirationDate": null
                }
            ]
        }
    ],
    "vasps": [
            "did:ethr:0x940a4b2a0932733b842e4aa906761bb3d3bd8148" < -- this is your VASP's DID
    ],
    "roles": [
        {
            "vaspDID": "did:ethr:0x940a4b2a0932733b842e4aa906761bb3d3bd8148",
            "permissions": [
                "manage",
                "address.uploadAddressList",
                "address.registerCustomer",
                "auth.customerToken",
                "auth.addUserToVASP",
                "auth.removeUserFromVASP",
              ....
                "trustframework.updateVASP",
                "trustframework.uploadVASPDocument",
                "trustframework.approveDocumentRequest",
                "trustFramework.getVaspAnalytics"
            ]
        }
        }
    ]
}

📘

No information

If the call to authViewer doesn't return any specific details, make sure that your VASP has been created in the test directory.

---

Finding a DID using the UI

---

Finding a DID by searching the network

You can also search for a VASP in our network here: TEST PROD, and see the DID in the URL after "network/" https://app.notabene.dev/network/did:ethr:0x46a7ed5813ce735387df2bfb245bd7722e0de992/hello-crypto