---
id: config-create-digital-wallet-open-id-individual-wallet-app
title: "Create wallet app"
description: "Adds an iOS or Android app of the wallet solution (`source` `interface`). The wallet provider registers a wallet unit only for an app that is `ready`, and it checks the app identity of each request against the apps: the App ID of the App Attest attestation (iOS), or the package name and a signing certificate digest of the Android Key Attestation chain (Android). An app can be saved before it is ready: `notReadyReason` says what is missing."
sidebar_label: "Create wallet app"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "post api-method"
info_path: docs/openid4vc-api/igrant-io-api-documentation
custom_edit_url: null
---

> **Build this with an AI coding agent.** Install the iGrant.io Agent Skills, then ask your agent to build the integration:
>
> ```bash
> npx skills add L3-iGrant/skills
> ```


import ApiTabs from "@theme/ApiTabs";
import DiscriminatorTabs from "@theme/DiscriminatorTabs";
import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
import MimeTabs from "@theme/MimeTabs";
import ParamsItem from "@theme/ParamsItem";
import ResponseSamples from "@theme/ResponseSamples";
import SchemaItem from "@theme/SchemaItem";
import SchemaTabs from "@theme/SchemaTabs";
import Markdown from "@theme/Markdown";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";

<h1 className={"openapi__heading"}>Create wallet app</h1>

<MethodEndpoint method={"post"} path={"/v4/config/ows/wallet-provider/individual-wallet-apps"}></MethodEndpoint>



Adds an iOS or Android app of the wallet solution (`source` `interface`). The wallet provider registers a wallet unit only for an app that is `ready`, and it checks the app identity of each request against the apps: the App ID of the App Attest attestation (iOS), or the package name and a signing certificate digest of the Android Key Attestation chain (Android). An app can be saved before it is ready: `notReadyReason` says what is missing.

For an Android app, copy the Play app signing certificate digest and the two Play Integrity keys of the classic requests from the Play Console. The keys are write-only: they are stored encrypted and never returned.

## Request

<MimeTabs className={"openapi-tabs__mime"}><TabItem label={"application/json"} value={"application/json-schema"}><details style={{}} className={"openapi-markdown__details mime"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-mime"}><h3 className={"openapi-markdown__details-summary-header-body"}>Body</h3><strong className={"openapi-schema__required"}>required</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}><div style={{"marginTop":"1rem","marginBottom":"1rem"}}>

The new wallet app.

</div></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"name"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** `non-empty` and `<= 100 characters`"} schema={{"type":"string","minLength":1,"maxLength":100,"description":"Required. The name of the app in the dashboard.","example":"Data Wallet Android"}}></SchemaItem><SchemaItem collapsible={false} name={"platform"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** [`ios`, `android`]"} schema={{"type":"string","description":"Required. `ios` or `android`. An update cannot change the platform of an app.","enum":["ios","android"],"example":"android"}}></SchemaItem><SchemaItem collapsible={false} name={"iosTeamId"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"iOS: the Apple Team ID of the developer account, 10 capital letters and digits.","example":"8XK2M4Q7ZD"}}></SchemaItem><SchemaItem collapsible={false} name={"iosBundleId"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"iOS: the bundle ID of the app, for example `io.igrant.datawallet`.","example":"io.igrant.datawallet"}}></SchemaItem><SchemaItem collapsible={false} name={"androidPackageName"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"Android: the package name (application ID) of the app, for example `io.igrant.datawallet`.","example":"io.igrant.datawallet"}}></SchemaItem><SchemaItem collapsible={false} name={"androidSigningCertificateDigests"} required={false} schemaName={"string[]"} qualifierMessage={"**Possible values:** `<= 20`"} schema={{"type":"array","maxItems":20,"description":"Android: the SHA-256 digest of the app signing certificate, as the Play Console shows it under App integrity > App signing (the certificate of the Play app signing key). Add another digest only for a build that is signed with another certificate. 64 hexadecimal digits; colons and capital letters are accepted, and the answer has the lowercase form without colons.","items":{"type":"string"},"example":["9F:86:D0:81:88:4C:7D:65:9A:2F:EA:A0:C5:5A:D0:15:A3:BF:4F:1B:2B:0B:82:2C:D1:5D:6C:15:B0:F0:0A:08"]}}></SchemaItem><SchemaItem collapsible={false} name={"playIntegrityDecryptionKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"Android: the decryption key of the classic Play Integrity requests of the app, the base64 of an AES-256 key. Get it in the Play Console under App integrity > Play Integrity API > Settings > Classic requests > Manage response encryption keys. Write-only: it is stored encrypted and is never in an answer. Send it together with `playIntegrityVerificationKey`. An update without the two keys keeps the stored keys.","example":"<base64 of the AES-256 decryption key>"}}></SchemaItem><SchemaItem collapsible={false} name={"playIntegrityVerificationKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"Android: the verification key of the classic Play Integrity requests of the app, the base64 of the DER public key (an EC P-256 key), from the same page of the Play Console. Write-only, as `playIntegrityDecryptionKey`.","example":"<base64 of the DER EC P-256 verification key>"}}></SchemaItem><SchemaItem collapsible={false} name={"minimumVersion"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"Optional. The lowest app version (dotted numbers, for example `2026.12.0`) that the wallet provider accepts in a signed request. Without it, or with `null`: no minimum.","example":"2026.12.0"}}></SchemaItem><SchemaItem collapsible={false} name={"androidMinimumVersionCode"} required={false} schemaName={"integer"} qualifierMessage={"**Possible values:** `<= 2100000000`"} schema={{"type":"integer","minimum":0,"maximum":2100000000,"description":"Optional. Android: the lowest `versionCode` of the app that the wallet provider accepts. For a `release` build, the wallet provider compares it with the app version in each Android Key Attestation chain (the registration, a key attestation request and the fresh chain of a Wallet Unit Attestation request), and refuses a lower or missing version with `403` (`app_version_too_old`). Without it, or with `0`: every version. An update without it sets it to `0`.","example":2026120001}}></SchemaItem><SchemaItem collapsible={false} name={"build"} required={false} schemaName={"string"} qualifierMessage={"**Possible values:** [`release`, `development`, `simulator`]"} schema={{"type":"string","description":"Optional. The build of the app, which decides the device evidence that a request of its wallet units must give. `release` (the default of a create): every check. `development`: the wallet provider accepts the App Attest development environment (iOS) and needs no Play Integrity token (Android). `simulator`: it checks only the request signature. An update without it keeps the stored build. Another value gives `400` (`build: must be release, development or simulator`).","enum":["release","development","simulator"],"example":"release"}}></SchemaItem></ul></details></TabItem></MimeTabs><div><div><ApiTabs label={undefined} id={undefined}><TabItem label={"201"} value={"201"}><div>

The new wallet app, with its ready state.

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><span className={"openapi-schema__container"}><strong className={"openapi-schema__property"}>walletApp</strong><span className={"openapi-schema__name"}> object</span></span></summary><div style={{"marginLeft":"1rem"}}><div style={{"marginTop":".5rem","marginBottom":".5rem"}}>

An iOS or Android app of the wallet solution. The wallet provider uses the apps for each request: it registers a wallet unit only for an app that is ready, and it checks the app identity of the device evidence against the app. The answer never has the Play Integrity keys.

</div><SchemaItem collapsible={false} name={"id"} required={true} schemaName={"uuid"} qualifierMessage={undefined} schema={{"type":"string","format":"uuid","description":"The id of the wallet app.","example":"5b0c6f0e-8f6d-4d2a-9a51-3f7a2c1e9b42"}}></SchemaItem><SchemaItem collapsible={false} name={"name"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"The name of the app in the dashboard.","example":"Data Wallet Android"}}></SchemaItem><SchemaItem collapsible={false} name={"platform"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** [`ios`, `android`]"} schema={{"type":"string","description":"The platform of the app. It does not change after the create.","enum":["ios","android"],"example":"android"}}></SchemaItem><SchemaItem collapsible={false} name={"iosTeamId"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","nullable":true,"description":"iOS: the Apple Team ID (10 capital letters and digits). The App ID of the app is `<iosTeamId>.<iosBundleId>`.","example":null}}></SchemaItem><SchemaItem collapsible={false} name={"iosBundleId"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","nullable":true,"description":"iOS: the bundle ID of the app.","example":null}}></SchemaItem><SchemaItem collapsible={false} name={"androidPackageName"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","nullable":true,"description":"Android: the package name (application ID) of the app.","example":"io.igrant.datawallet"}}></SchemaItem><SchemaItem collapsible={false} name={"androidSigningCertificateDigests"} required={true} schemaName={"string[]"} qualifierMessage={"**Possible values:** Value must match regular expression `^[0-9a-f]{64}$`"} schema={{"type":"array","description":"Android: the SHA-256 digests of the app signing certificates, in lowercase hexadecimal (64 digits). An empty array for an iOS app.","example":["9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"],"items":{"type":"string","pattern":"^[0-9a-f]{64}$"}}}></SchemaItem><SchemaItem collapsible={false} name={"playIntegrityKeysSet"} required={true} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean","description":"Android: `true` when the Play Integrity decryption key and verification key are stored. The keys themselves are never in an answer.","example":true}}></SchemaItem><SchemaItem collapsible={false} name={"minimumVersion"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","nullable":true,"description":"The lowest app version (`X-Wallet-App-Version`, dotted numbers) that the wallet provider accepts in a signed request. `null`: no minimum.","example":"2026.12.0"}}></SchemaItem><SchemaItem collapsible={false} name={"androidMinimumVersionCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"Android: the lowest app version code that the wallet provider accepts in the Android Key Attestation. `0`: every version.","example":0}}></SchemaItem><SchemaItem collapsible={false} name={"build"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** [`release`, `development`, `simulator`]"} schema={{"type":"string","description":"The build of the app: `release`, `development` or `simulator`. It decides the device evidence that a request of its wallet units must give.","enum":["release","development","simulator"],"example":"release"}}></SchemaItem><SchemaItem collapsible={false} name={"ready"} required={true} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean","description":"`true` when the app has every value that its checks need: the Team ID and the bundle ID (iOS), or the package name, a signing certificate digest and the Play Integrity keys (Android).","example":true}}></SchemaItem><SchemaItem collapsible={false} name={"notReadyReason"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** [`ios_app_id_missing`, `package_missing`, `digest_missing`, `play_integrity_keys_missing`]"} schema={{"type":"string","nullable":true,"description":"Why the app is not ready, or `null` for a ready app: `ios_app_id_missing`, `package_missing`, `digest_missing` or `play_integrity_keys_missing`.","enum":["ios_app_id_missing","package_missing","digest_missing","play_integrity_keys_missing"],"example":null}}></SchemaItem><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><span className={"openapi-schema__container"}><strong className={"openapi-schema__property"}>walletUnits</strong><span className={"openapi-schema__name"}> object</span><span className={"openapi-schema__divider"}></span><span className={"openapi-schema__required"}>required</span></span></summary><div style={{"marginLeft":"1rem"}}><div style={{"marginTop":".5rem","marginBottom":".5rem"}}>

The wallet units of the app that are not deleted, by state.

</div><SchemaItem collapsible={false} name={"active"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":1840}}></SchemaItem><SchemaItem collapsible={false} name={"revoked"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":12}}></SchemaItem></div></details></SchemaItem><SchemaItem collapsible={false} name={"source"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** [`interface`, `installation`]"} schema={{"type":"string","description":"`installation`: the wallet provider made the app once from the values of the installation. `interface`: an admin or an API key made it.","enum":["interface","installation"],"example":"installation"}}></SchemaItem><SchemaItem collapsible={false} name={"createdAt"} required={true} schemaName={"int64"} qualifierMessage={undefined} schema={{"type":"integer","format":"int64","description":"When the app was made (Unix time in seconds).","example":1794556800}}></SchemaItem><SchemaItem collapsible={false} name={"updatedAt"} required={true} schemaName={"int64"} qualifierMessage={undefined} schema={{"type":"integer","format":"int64","description":"When the app last changed (Unix time in seconds).","example":1794560400}}></SchemaItem></div></details></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"walletApp\": {\n    \"id\": \"5b0c6f0e-8f6d-4d2a-9a51-3f7a2c1e9b42\",\n    \"name\": \"Data Wallet Android\",\n    \"platform\": \"android\",\n    \"iosTeamId\": null,\n    \"iosBundleId\": null,\n    \"androidPackageName\": \"io.igrant.datawallet\",\n    \"androidSigningCertificateDigests\": [\n      \"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08\"\n    ],\n    \"playIntegrityKeysSet\": true,\n    \"minimumVersion\": \"2026.12.0\",\n    \"androidMinimumVersionCode\": 0,\n    \"build\": \"release\",\n    \"ready\": true,\n    \"notReadyReason\": null,\n    \"walletUnits\": {\n      \"active\": 1840,\n      \"revoked\": 12\n    },\n    \"source\": \"installation\",\n    \"createdAt\": 1794556800,\n    \"updatedAt\": 1794560400\n  }\n}"} language={"json"}></ResponseSamples></TabItem><TabItem label={"Example"} value={"Example"}><ResponseSamples responseExample={"{\n  \"walletApp\": {\n    \"id\": \"5b0c6f0e-8f6d-4d2a-9a51-3f7a2c1e9b42\",\n    \"name\": \"Data Wallet Android\",\n    \"platform\": \"android\",\n    \"iosTeamId\": null,\n    \"iosBundleId\": null,\n    \"androidPackageName\": \"io.igrant.datawallet\",\n    \"androidSigningCertificateDigests\": [\n      \"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08\"\n    ],\n    \"playIntegrityKeysSet\": true,\n    \"minimumVersion\": \"2026.12.0\",\n    \"androidMinimumVersionCode\": 2026120001,\n    \"build\": \"release\",\n    \"ready\": true,\n    \"notReadyReason\": null,\n    \"walletUnits\": {\n      \"active\": 0,\n      \"revoked\": 0\n    },\n    \"source\": \"interface\",\n    \"createdAt\": 1794556800,\n    \"updatedAt\": 1794556800\n  }\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"400"} value={"400"}><div>

The body is not valid (an unknown member, a value of the wrong JSON type, a missing `name` or `platform`, a `platform` other than `ios` or `android`, an `iosTeamId`, `iosBundleId`, `androidPackageName` or `minimumVersion` of another form, a digest that is not a SHA-256 in hexadecimal, one Play Integrity key without the other, a `playIntegrityDecryptionKey` that is not the base64 of a 256-bit AES key, or a `playIntegrityVerificationKey` that is not the base64 DER of an EC P-256 public key), or the organisation is not the wallet provider (also without a deployment).

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem><SchemaItem collapsible={false} name={"errorKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A text code of the refusal that does not change when the text changes. Only some refusals have it, for example `organisation_suspended`, `feature_disabled`, `service_not_installed` or `purpose_exists`. Some refusals have more members: `feature_disabled` has `feature`, and `service_not_installed` has `service` (the service that is not installed: `wallet` or `consent`)."}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\",\n  \"errorKey\": \"string\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"401"} value={"401"}><div>

The `Authorization` header is missing, or the API key or token is not valid.

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem><SchemaItem collapsible={false} name={"errorKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A text code of the refusal that does not change when the text changes. Only some refusals have it, for example `organisation_suspended`, `feature_disabled`, `service_not_installed` or `purpose_exists`. Some refusals have more members: `feature_disabled` has `feature`, and `service_not_installed` has `service` (the service that is not installed: `wallet` or `consent`)."}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\",\n  \"errorKey\": \"string\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"403"} value={"403"}><div>

The API key or token does not allow this call. An API key without the scope of the operation gets the older body `{"Code", "Message"}`. An `X-SandboxOrgId` header that names another sandbox organisation than the one of the API key gets `{"errorCode", "errorDescription"}`. When a platform admin has turned off the feature of the operation for the organisation, the answer has `errorKey` `feature_disabled` and the member `feature` (the name of the feature).

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><div><span className={"badge badge--info"}>anyOf</span><SchemaTabs><TabItem label={"MOD1"} value={"0-item-properties"}><SchemaItem collapsible={false} name={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem><SchemaItem collapsible={false} name={"errorKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A text code of the refusal that does not change when the text changes. Only some refusals have it, for example `organisation_suspended`, `feature_disabled`, `service_not_installed` or `purpose_exists`. Some refusals have more members: `feature_disabled` has `feature`, and `service_not_installed` has `service` (the service that is not installed: `wallet` or `consent`)."}}></SchemaItem></TabItem><TabItem label={"Older error body"} value={"1-item-properties"}><SchemaItem collapsible={false} name={"Code"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"The HTTP status.","example":403}}></SchemaItem><SchemaItem collapsible={false} name={"Message"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"What went wrong.","example":"Unauthorised access;User doesn't have enough permissions;"}}></SchemaItem></TabItem></SchemaTabs></div></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{}"} language={"json"}></ResponseSamples></TabItem><TabItem label={"Example"} value={"Example"}><ResponseSamples responseExample={"{\n  \"Code\": 403,\n  \"Message\": \"Unauthorised access;User doesn't have enough permissions;\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"500"} value={"500"}><div>

Unexpected server error.

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem><SchemaItem collapsible={false} name={"errorKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A text code of the refusal that does not change when the text changes. Only some refusals have it, for example `organisation_suspended`, `feature_disabled`, `service_not_installed` or `purpose_exists`. Some refusals have more members: `feature_disabled` has `feature`, and `service_not_installed` has `service` (the service that is not installed: `wallet` or `consent`)."}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\",\n  \"errorKey\": \"string\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem></ApiTabs></div></div>
      