Getting started

Number of APIs: 14

This guide helps you start with iGrant.io data intermediation services using Data Wallet and Digital Rights Management APIs. This is intended for developers who want to integrate digital wallets into their applications. It is assumed that you follow the iGrant.io commercial policy. There are three stages to using the iGrant.io data intermediation service.

Support

Please contact iGrant.io support through WhatsApp or send an email request to support@igrant.io.

Workflows

1)The organisation establishes a connection towards Individuals

The wallet connects to an organisation via a QR code or an NFC blip. Once connected, the organisation can get the connection status.

2) The organisation (Data Source) exposes data towards Individuals.

Here, the organisation (Data Source) issues a credential towards the connected wallet. The credentials are defined as data agreements. The organisation can get the issue status via webhook notifications.

3) The organisation (Data Using Service) consumes/verifies data from Individuals.

Here, the organisation (Data Using Service) requests the data from the wallet. The requested credentials are defined as data agreements. The organisation can get the verification status via webhook notifications.

  1. 2.0 Define Data Agreements - Create data agreement POST {{cloudagent}}/v1/data-agreements?draft=false

  2. 2.0 Define Data Agreements - Fetch data agreement GET {{cloudagent}}/v1/data-agreements?data_agreement_id={{dataAgreementId}}&publish_flag=true

  3. 2.0 Define Data Agreements - Update data agreement PUT {{cloudagent}}/v1/data-agreements/:data_agreement_id?draft=false

  4. 2.0 Define Data Agreements - Delete data agreement DELETE {{cloudagent}}/v1/data-agreements/:data_agreement_id

  5. 4.0 Implement APIs-4.1 Establishing connection with Cloud/Mobile wallets - Fetch connection record GET {{cloudagent}}/connections/:connectionId

  6. 4.0 Implement APIs-4.1 Establishing connection with Cloud/Mobile wallets - Create a new connection invitation POST {{cloudagent}}/v2/connections/create-invitation?auto_accept=true

  7. 4.0 Implement APIs-4.1 Establishing connection with Cloud/Mobile wallets - Create Firebase dynamic link for connection record POST {{cloudagent}}/v1/connections/:connection_id/invitation/firebase

  8. 4.0 Implement APIs-4.2 Issue/expose data to a connection (Data Source) - Fetch credential issuance history record GET {{cloudagent}}/issue-credential/records/:cred_ex_id

  9. 4.0 Implement APIs-4.2 Issue/expose data to a connection (Data Source) - Issue credential to connection POST {{cloudagent}}/issue-credential/send-offer

  10. 4.0 Implement APIs-4.3 Verify/consume data from a connection (Data Using Service) - Send verification request to connection POST {{cloudagent}}/present-proof/data-agreement-negotiation/offer