Attestation request

In this section we describe how to create new attestation requests

Create an attestation request using API. In this example, you will request an onboarding attestation.

Get the connection ID:

• Create a new GET request like previously and enter the value: « {{base_URL}}/connections »

• In the Params tab, add a Key "status" with the Value "active"

• Save the request and click SEND

Response:

{
    "count": 2,
    "results": [
        {
            "createdAt": "2024-06-21T07:31:07.241Z",
            "updatedAt": "2024-06-21T07:31:07.241Z",
            "id": "16787c48-7548-4f41-9770-a16212548866",
            "contact": {
                "did": "Gjr2SvNwhHe3ZhmUNjKqHT",
                "organization": {
                    "siren": "889098612",
                    "address": "45-47 Boulevard Paul Vaillant Couturier, 94200 Ivry-sur-Seine, FRANCE",
                    "name": "ARCHIPELS"
                },
                "wallet": {
                    "type": "business",
                    "label": "Archipels",
                    "dids": [
                        "Gjr2SvNwhHe3ZhmUNjKqHT"
                    ]
                }
            },
            "label": "Archipels",
            "status": "active"
        },
        {
            "createdAt": "2024-06-10T14:54:21.064Z",
            "updatedAt": "2024-06-10T14:54:21.064Z",
            "id": "ce62c01c-3534-4530-a035-1a46ac3a6d4a",
            "contact": {
                "did": "X8SoDjXKfrRZgFJ8m6MYu3",
                "organization": {
                    "siren": "338885718",
                    "address": "5-7 Avenue de Paris, 94307 Vincennes Cedex, FRANCE",
                    "name": "INFOGREFFE"
                },
                "wallet": {
                    "type": "business",
                    "label": "Infogreffe",
                    "dids": [
                        "X8SoDjXKfrRZgFJ8m6MYu3"
                    ]
                }
            },
            "label": "Infogreffe",
            "status": "active"
        }
    ]
}

In our example, the connection ID for the issuer Archipels (DID Gjr2SvNwhHe3ZhmUNjKqHT) is the first id: 16787c48-7548-4f41-9770-a16212548866. So you need to identify the Archipels wallet (label: "Archipels", type: "business") and copy the corresponding connection ID.

• Your connectionID will have a specific value. Don't reuse the one in the example

• Archipels business DID will be different from the example provided

If the request doesn't provide any existing connection, it means you have never been connected with one of the issuer from the list, or the connection has been closed or is pending. In this case you need to create the connection: Option 1: request an attestation like describe in the Set up chapter or in get attestation chapter Option 2: go to the page "Accept an invitation"

Now that you have all the data, you can create the Attestation send request using Chats feature

• Create a new request but with the Method POST and the value {{base_URL}}/messages

• Select the tab Body, then select « raw » and copy/paste this json request (replacing the connectionId by your value):

{
    "content": "/onboarding_attestation",
    "connectionId": "16787c48-7548-4f41-9770-a16212548866",
    "metadata":{
        "init": true
    }
}

• Save the request and click on SEND

• The response is 204 no content when your request is received

• At the same time, a webhook is sent to the holder:

{
  "payload": {
    "content": "/onboarding_attestation",
    "connectionId": "d557c7ae-9fbe-4677-a4aa-c1c700739806"
  },
  "timestamp": "2024-04-16T08:28:59.399Z",
  "type": "MessageInitiated"
}