---
id: config-digital-wallet-open-id-receive-verifiable-authorisation-to-onboard
title: "Receive Verifiable Authorisation To Onboard credential"
description: "Receives a Verifiable Authorisation to Onboard credential from the EBSI Trust Registry, which grants permission to participate in the trust chain as a Root TAO."
sidebar_label: "Receive Verifiable Authorisation To Onboard credential"
hide_title: true
hide_table_of_contents: true
api: eJzlVt9v2zgM/lcIPbWAE6ddBxyCYbg26Q7ZhmvRZO1DV6CMzdhabcmT5GRZ4P99oOT8XHu7u7fDvSS2LFLkx08fuRIp2cTIykmtRF/cUEJyThYQbsnImcRpQXBeu1wbaZF3gdNwpaYaTQqJoZSUk1jAzOgSXE5weTEewcTU1sENZdI6s4xgkcskh8ygchYqMqW0tvVVoXEykRU6Aqm8C+etkxylAuRYbrR2MDm/6opI6IqMD2SUir5ItJrJbCgz6bC4w6Igd1WRGqVtJtss9pKY6DYFEQlDX2uy7kKnS9FfsUdHyvEjVlUhE28Qf7EM0ErYJKcS+akyHIqTZPlt/quD+ivhlhWJvrDOSJWJponWK3r6hRInmobXDNlKKxvcnvZ6/LdfJRH92yilbcORKju3DOsE9UhdG50ZsnYnyKnWBaESTbQ1onRj89LOX+HdliV9zv45PCKRE6ZkODR+O+ud/KMicXGl4fPuBRmjzUCnJKLwPNxB9eHw8OgAuq31NnSpHGVk2N83LKuCRP+s12uecf9T9XdMxAWmIFVVO74MWJIj47nQRAeF/6QwoPqdmLn70LwOVPmfQjNSjozCAiyZORnwxxxg1ETCUlIb6Zaif78S55X8QPz40EQrcUFoyDBt/QpnjZlldFp5gaAvcOQVZnh2OzgWkQhSd66SXBuGqiSXa5amSlsPFbJDEc9P4yBWcRrcdRbeXawrUjKNveh10PuJ56hjE66K4KA5Jetj3s96SKVuMxaRqE0h+iJ3rrL9OE6p1B2sZFd63e1KLTjNfQfXRqd14nX9BTe/8jB2mEmVvWRuw+fDQB62pRgzIwOR1gXZMALDQiQkHxVqKSKhsOSvrcR89wwXh4w4vx7BEy2Brww3qXARujDJCeZY1AR65tvN456fRwjHQMl1nRJUhmbyG6WwkC6HxxAjPMKR0o7afoWy8BhUmNBxBNTNugdu+9Aavlnq2jAcnSdavn3ssm7uUm8lpv7tnTYlOtEX7+8mP+eWJGQtOP1ECiq0dh1e8NTGzP10LwjYIOhlwKuvNxCbK85181LMgnGzbY2X6yv5d1rdpsVx4WZ6LUuYeFmiEiVTxNZVpY37fUuLTWXlH9ulfT7tUvEAlI0RVEbPZerHmERz2Dxb8H9JygUk2tqHqwwzbXYHnsFmrrEwsrZGlRAcXfk7PzoGVOkLhteG7OaIjU5cH3NETie6sMw/aYHJSYptLGiToWorxDUFaW1NEeS6SCN/mEd8Ca1w7IxdFmrriedQpWhS2/H5SlQOZoVe2MCKFmkf7d2rAdwO4Oj93eQ4gtHl5B2Mh533dxO4HYTTRuMrOPmtd/Kq8xrKoU7icvhxb9TzzLQ8jBUyIWU9K9Z3ssIkJzjt9n4q3WKx6KL/3NUmi1tbG38cDS7/HF922IZnAOmKPQ54sFKd1JvqiYhJaEPZT3unZ91X3RO2Zc0tUe3E0w4cL4+zk+fG2cMLt9NW/wszcnuXHX1zcVWg9MOZL8aq7Uf3Yn4axsiZ5I6735PCmK0kDxm7fYlxR+1n5tCbHiKRc5vr34vVaoqWPpmiaXj5a03Gt1Y2MR6j0GjXKs7N7InFXgwCtJ0JR83bizpo/8H0wr0nWLD8Ve4v9+524uurMUvotJ3wSz+pCIMLzgQXoi8+i8/CJ+3voJ+OeH0lClRZjRnvD35ZGrEV6m2TevJNqn3gzNaf1HInysN+FZLhX07tWZM3zP0PtHy72R6+vGiwUfiwm0v/0DTND2Tp2yc=
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"}>Receive Verifiable Authorisation To Onboard credential</h1>

<MethodEndpoint method={"post"} path={"/v2/config/digital-wallet/openid/trust-anchor/vao/receive"}></MethodEndpoint>



Receives a Verifiable Authorisation to Onboard credential from the EBSI Trust Registry, which grants permission to participate in the trust chain as a Root TAO.

## 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></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"verifiableAuthorisationToOnboard"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string"}}></SchemaItem></ul></details></TabItem></MimeTabs><div><div><ApiTabs label={undefined} id={undefined}><TabItem label={"200"} value={"200"}><div></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={"isOnboardingAsRootTaoInProgress"} required={false} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean"}}></SchemaItem><SchemaItem collapsible={false} name={"isOnboardedAsRootTao"} required={false} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean"}}></SchemaItem><SchemaItem collapsible={false} name={"isVerifiableAuthorisationToOnboardReceived"} required={false} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean"}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"isOnboardingAsRootTaoInProgress\": true,\n  \"isOnboardedAsRootTao\": true,\n  \"isVerifiableAuthorisationToOnboardReceived\": true\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>