---
id: config-read-digital-wallet-open-id-wallet-unit-status
title: "Read wallet unit status"
description: "Reads the wallet unit status from the holder's point of view. The status follows the Wallet Unit Attestation (WUA) lifecycle and the presence of a Legal Person Identification Data (LPID) credential in the wallet."
sidebar_label: "Read wallet unit status"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get 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"}>Read wallet unit status</h1>

<MethodEndpoint method={"get"} path={"/v2/config/digital-wallet/openid/wallet-unit/status"}></MethodEndpoint>



Reads the wallet unit status from the holder's point of view. The status follows the Wallet Unit Attestation (WUA) lifecycle and the presence of a Legal Person Identification Data (LPID) credential in the wallet.

## Request

<details style={{"marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collapsed={false} open={true}><summary style={{}}><h3 className={"openapi-markdown__details-summary-header-params"}>Header Parameters</h3></summary><div><ul><ParamsItem className={"paramsItem"} param={{"description":"Optional. Unique identifier of the sandbox organisation to use for this request. When you send this header, the service runs the operation in the context of the named sandbox organisation, that is, against the wallet of that sandbox organisation and not against the main wallet of the organisation. Leave the header out to use the main wallet.\n\nThe service reads this header only when you authenticate with a bearer access token. When you authenticate with an API key, the service takes the sandbox organisation from the API key and ignores this header. To run an API-key call in a sandbox organisation, bind the key to the sandbox organisation with `PUT /v2/config/admin/apikey/{apiKeyId}/sandbox-org` instead.\n\n`X-SubwalletId` is the deprecated name of this header. The service continues to accept it, but `X-SandboxOrgId` wins if you send both headers.\n\nThe sandbox organisation must exist, must belong to your organisation and must be deployed. An unknown identifier, an identifier of a sandbox organisation that is not deployed, and an identifier that belongs to a different organisation all make the call fail with HTTP 400.","in":"header","name":"X-SandboxOrgId","required":false,"schema":{"type":"string"},"example":"6889e1a4c5b2f30001a3d710"}}></ParamsItem></ul></div></details><div><div><ApiTabs label={undefined} id={undefined}><TabItem label={"200"} value={"200"}><div>

The server returns the wallet unit status.

</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={"status"} required={false} schemaName={"string"} qualifierMessage={"**Possible values:** [`not_installed`, `installed`, `operational`, `valid`]"} schema={{"type":"string","description":"Wallet unit status:\n1. `not_installed`: The organisation has no wallet deployment.\n2. `installed`: The wallet is deployed, but it holds no valid Wallet Unit Attestation.\n3. `operational`: The wallet holds a valid Wallet Unit Attestation, but no LPID credential.\n4. `valid`: The wallet holds a valid Wallet Unit Attestation and an LPID credential.\n","enum":["not_installed","installed","operational","valid"],"example":"operational"}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"status\": \"operational\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"400"} value={"400"}><div>

The server cannot read the wallet unit status for the organisation.

</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></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"401"} value={"401"}><div>

Unauthorized

</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></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"500"} value={"500"}><div>

The organisation is unknown.

</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></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem></ApiTabs></div></div>