---
id: config-read-digital-wallet-open-id-device-policy-configuration
title: "Read device policy configuration"
description: "Reads the device policy configuration of the wallet provider of the individual wallet units: the device rules on Android. The configuration has the minimum Android version (`minimumAndroidVersion`). The key origin rule is always on, so it has no member. There is one device policy configuration for each wallet provider, so the path has no id. A new configuration has no minimum Android version."
sidebar_label: "Read device policy configuration"
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 device policy configuration</h1>

<MethodEndpoint method={"get"} path={"/v4/config/ows/wallet-provider/individual-wallet-unit-device-policy/configuration"}></MethodEndpoint>



Reads the device policy configuration of the wallet provider of the individual wallet units: the device rules on Android. The configuration has the minimum Android version (`minimumAndroidVersion`). The key origin rule is always on, so it has no member. There is one device policy configuration for each wallet provider, so the path has no id. A new configuration has no minimum Android version.

<div><div><ApiTabs label={undefined} id={undefined}><TabItem label={"200"} value={"200"}><div>

The device policy configuration.

</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"}>devicePolicyConfiguration</strong><span className={"openapi-schema__name"}> object</span></span></summary><div style={{"marginLeft":"1rem"}}><div style={{"marginTop":".5rem","marginBottom":".5rem"}}>

The device policy configuration of the wallet provider of the individual wallet units: the device rules on Android. The wallet provider applies them to each fresh Android Key Attestation chain: the chain of the device key at the registration, the chain of each attested key of a key attestation request, and the fresh chain of a Wallet Unit Attestation request (403 `individual_wallet_unit.device_refused` with the reason `key_not_generated_in_hardware` or `os_version_too_old`). The key origin rule has no member: it is always on. The Device Policy scan applies the rules to the stored values of the wallet units.

</div><SchemaItem collapsible={false} name={"minimumAndroidVersion"} required={true} schemaName={"integer"} qualifierMessage={"**Possible values:** `>= 9` and `<= 99`"} schema={{"type":"integer","minimum":9,"maximum":99,"nullable":true,"description":"The minimum major Android version of the attested `osVersion`. `null`: no minimum (the default).","example":13}}></SchemaItem></div></details></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"devicePolicyConfiguration\": {\n    \"minimumAndroidVersion\": 13\n  }\n}"} language={"json"}></ResponseSamples></TabItem><TabItem label={"Example"} value={"Example"}><ResponseSamples responseExample={"{\n  \"devicePolicyConfiguration\": {\n    \"minimumAndroidVersion\": null\n  }\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"400"} value={"400"}><div>

The organisation has no deployment, or it is not the wallet provider (`Invalid request, wallet provider not found`). A sandbox organisation is not a wallet provider.

</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={"404"} value={"404"}><div>

The wallet provider has no configuration of the individual wallet units. The wallet makes it when the organisation becomes the wallet provider, so this is not a normal case.

</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={"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>
      