Skip to main content
Version: 2024.3.1

iGrant.io API documentation

iGrant.io (™) is a Swedish data exchange and verification service provider. It uses self-sovereign identity, verifiable credentials, a digital wallet and solid pod technologies, enabling a new level of interoperability and automating compliance with data regulations in a fully auditable manner.

Authentication​

API key authentication. The value of the Authorization header must be prefixed with ApiKey (note the trailing space), e.g. Authorization: ApiKey <your-api-key>. An API key is an opaque value that starts with owsk_. A key in the older JWT form (it starts with eyJ) no longer works: it gets 401, the same answer as an unknown key. To replace a key, create a new key in the dashboard under Account > Developer APIs > Create API Key (for a key of a sandbox organisation, select the sandbox organisation first), use the new key, then delete the old key. An API key works only in the organisation or the sandbox organisation that it is bound to, so send no X-SandboxOrgId header with it: a request with an API key and an X-SandboxOrgId header that is not the sandbox organisation of the key gets 403.

While a platform admin has suspended your organisation (also after its deletion started), each call with an API key of the organisation gets 401 with errorKey organisation_suspended. A route of a product feature that is off for your organisation (consentManagement or dataDisclosureAgreements) gets 403 with errorKey feature_disabled and the member feature, the name of the feature. An installation can run without the consent service or without the wallet: each route of a service that is not installed gets 404 with errorKey service_not_installed and the member service (consent or wallet), before the check of the key.

Security Scheme Type:apiKey
Header parameter name:Authorization

License

Apache 2.0