---
id: config-list-digital-wallet-open-id-credential-definition-templates
title: "List credential definition templates"
description: "Lists the pre-defined credential schema templates that you can use to create a credential definition. The platform returns only the latest version of each schema. A claim path pointer schema has one entry for each credential format, so the same `name` and `version` can appear more than once. When the platform cannot read the schema repository, it returns an empty `templates` array and no `pagination` object."
sidebar_label: "List credential definition templates"
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 credential definition templates</h1>

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



Lists the pre-defined credential schema templates that you can use to create a credential definition. The platform returns only the latest version of each schema. A claim path pointer schema has one entry for each credential format, so the same `name` and `version` can appear more than once. When the platform cannot read the schema repository, it returns an empty `templates` array and no `pagination` object.


## 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><div><div><ApiTabs label={undefined} id={undefined}><TabItem label={"200"} value={"200"}><div>

Credential definition templates listed successfully

</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={"templates"} required={false} schemaName={"object[]"} qualifierMessage={undefined} schema={{"description":"Credential schema templates for the current page.","items":{"allOf":[{"type":"object","description":"Pre-defined credential schema that you can use as a template for a new credential definition. The platform reads the templates from the public credential schema repository. A claim path pointer schema has one entry for each credential format, so the same `name` and `version` can appear more than once in the list.\n","properties":{"name":{"type":"string","description":"Schema identifier. This value is the folder name of the schema in the credential schema repository.","example":"LegalPersonIdentificationData"},"type":{"type":"string","description":"Dialect of the schema document, and the field that tells you how to use it. `claimPathPointer` is a claim path pointer document, which is the dialect of OpenID4VCI 1.0. `jsonSchema` is a JSON Schema document that earlier versions of this API used; do not use it for a new credential definition.\n","enum":["jsonSchema","claimPathPointer"]},"version":{"type":"string","description":"Semantic version of the schema. The platform returns only the latest version of each schema.","example":"1.0.0"},"schema":{"type":"object","additionalProperties":true,"description":"The schema document. For a `claimPathPointer` template, copy this object into `credentialDefinitions[].claims` when the credential format is `dc+sd-jwt` or `mso_mdoc`, and into `credentialDefinitions[].credentialDefinition` when the credential format is `jwt_vc_json`.\n"},"metadata":{"type":"object","properties":{"id":{"type":"string","description":"Schema identifier","example":"WgWxqztrNooG92RXvxSTWv"},"credentialType":{"type":"string","description":"Schema name","example":"LegalPersonIdentificationData"},"isJwt":{"type":"boolean","description":"Is W3C VC(JWT) format supported","example":true},"isMsoMdoc":{"type":"boolean","description":"Is ISO 18013-5 mdoc/mDL format supported","example":true},"isSdJwt":{"type":"boolean","description":"Is IETF SD-JWT VC format supported","example":true},"title":{"type":"string","description":"Title of schema","example":"Legal Person Identification Data (LPID)"},"isClaimPathPointer":{"type":"boolean","description":"When `true`, `schema` is a claim path pointer document. The platform always sets this field.","example":true},"doctype":{"type":"string","description":"Document type identifier to use when the credential format is `mso_mdoc`.","example":"org.iso.18013.5.1.mDL"},"namespace":{"type":"string","description":"mDoc namespace of the schema. For OpenID4VCI 1.0, it is the first element of each claim path.","example":"org.iso.18013.5.1"},"versionSupported":{"type":"array","items":{"type":"string"},"description":"Versions of the OID4VCI specification that this schema supports.","example":["version_01"]}}}},"required":["name","type","version","schema","metadata"]}]},"type":"array"}}></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"}}><div style={{"marginTop":".5rem","marginBottom":".5rem"}}>

Offset based pagination for the template list. This operation does not use the page based pagination of the other list operations.

</div><SchemaItem collapsible={false} name={"offset"} required={false} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"Number of templates that the server skipped.","example":0}}></SchemaItem><SchemaItem collapsible={false} name={"limit"} required={false} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"Maximum number of templates per page. Defaults to 10.","example":10}}></SchemaItem><SchemaItem collapsible={false} name={"totalItems"} required={false} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"Total number of templates available.","example":12}}></SchemaItem><SchemaItem collapsible={false} name={"hasPrevious"} required={false} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean","description":"Indicates whether a previous page exists.","example":false}}></SchemaItem><SchemaItem collapsible={false} name={"hasNext"} required={false} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean","description":"Indicates whether a next page exists.","example":true}}></SchemaItem></div></details></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"templates\": [\n    {\n      \"name\": \"LegalPersonIdentificationData\",\n      \"type\": \"jsonSchema\",\n      \"version\": \"1.0.0\",\n      \"schema\": {},\n      \"metadata\": {\n        \"id\": \"WgWxqztrNooG92RXvxSTWv\",\n        \"credentialType\": \"LegalPersonIdentificationData\",\n        \"isJwt\": true,\n        \"isMsoMdoc\": true,\n        \"isSdJwt\": true,\n        \"title\": \"Legal Person Identification Data (LPID)\",\n        \"isClaimPathPointer\": true,\n        \"doctype\": \"org.iso.18013.5.1.mDL\",\n        \"namespace\": \"org.iso.18013.5.1\",\n        \"versionSupported\": [\n          \"version_01\"\n        ]\n      }\n    }\n  ],\n  \"pagination\": {\n    \"offset\": 0,\n    \"limit\": 10,\n    \"totalItems\": 12,\n    \"hasPrevious\": false,\n    \"hasNext\": true\n  }\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>