---
id: config-list-digital-wallet-open-id-scopes
title: "List scope"
description: "Lists the OAuth 2.0 scopes available for OID4VCI credential issuance, as published in the Credential Issuer Metadata. Use a value from this list in `credentialDefinitions[].scope` of a create or update credential definition request, when `authorizationRequestType` is `scope_based`."
sidebar_label: "List scope"
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"}>List scope</h1>

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



Lists the OAuth 2.0 scopes available for OID4VCI credential issuance, as published in the Credential Issuer Metadata. Use a value from this list in `credentialDefinitions[].scope` of a create or update credential definition request, when `authorizationRequestType` is `scope_based`.


## Request

<details style={{"marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collapsed={false} open={true}><summary style={{}}><h3 className={"openapi-markdown__details-summary-header-params"}>Query Parameters</h3></summary><div><ul><ParamsItem className={"paramsItem"} param={{"description":"Number of records to skip for pagination. A negative or unreadable value falls back to `0`.","in":"query","name":"offset","required":false,"schema":{"type":"integer","default":0,"minimum":0}}}></ParamsItem><ParamsItem className={"paramsItem"} param={{"name":"limit","in":"query","description":"Maximum number of records to return per page.","required":false,"schema":{"type":"integer","default":10}}}></ParamsItem></ul></div></details><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 scopes for the current page.

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

Scopes for the current page. Each scope maps to a credential configuration in the OID4VCI Credential Issuer Metadata.

</div><li><div style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem","paddingBottom":".5rem"}}>Array [</div></li><SchemaItem collapsible={false} name={"id"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"Unique identifier for the scope record."}}></SchemaItem><SchemaItem collapsible={false} name={"scope"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"OAuth 2.0 scope value mapped to a credential type in the OID4VCI Credential Issuer Metadata."}}></SchemaItem><SchemaItem collapsible={false} name={"createdAt"} required={true} schemaName={"number"} qualifierMessage={undefined} schema={{"type":"number","description":"Unix timestamp (in seconds) when the scope was created."}}></SchemaItem><SchemaItem collapsible={false} name={"updatedAt"} required={true} schemaName={"number"} qualifierMessage={undefined} schema={{"type":"number","description":"Unix timestamp (in seconds) when the scope was last modified."}}></SchemaItem><li><div style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem"}}>]</div></li></div></details></SchemaItem><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><span className={"openapi-schema__container"}><strong className={"openapi-schema__property"}>pagination</strong><span className={"openapi-schema__name"}> object</span></span></summary><div style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"currentPage"} required={false} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"Current page number","example":1}}></SchemaItem><SchemaItem collapsible={false} name={"totalItems"} required={false} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"Total number of items available","example":25}}></SchemaItem><SchemaItem collapsible={false} name={"totalPages"} required={false} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"Total number of pages based on limit","example":3}}></SchemaItem><SchemaItem collapsible={false} name={"limit"} required={false} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"Number of items per page","example":10}}></SchemaItem><SchemaItem collapsible={false} name={"hasPrevious"} required={false} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean","description":"Indicates if there's a previous page","example":false}}></SchemaItem><SchemaItem collapsible={false} name={"hasNext"} required={false} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean","description":"Indicates if there's a next page","example":true}}></SchemaItem></div></details></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"scope\": [\n    {\n      \"id\": \"string\",\n      \"scope\": \"string\",\n      \"createdAt\": 0,\n      \"updatedAt\": 0\n    }\n  ],\n  \"pagination\": {\n    \"currentPage\": 1,\n    \"totalItems\": 25,\n    \"totalPages\": 3,\n    \"limit\": 10,\n    \"hasPrevious\": false,\n    \"hasNext\": true\n  }\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"400"} value={"400"}><div>

The organisation is unknown, the wallet is not deployed, or the issuer cannot read the scopes.

</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>

Internal 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></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>