---
id: get-oidc-auth
title: "Authorisation Endpoint"
description: "OpenID Connect authorization endpoint that initiates the authentication flow. Returns an HTML page where individuals can authenticate using their EUDI Wallet through QR code or deep link verification."
sidebar_label: "Authorisation Endpoint"
hide_title: true
hide_table_of_contents: true
api: eJzdWM1uG0cMfhViTgmwltKkJ6Eo6sROqjZp0vwgLQIjpnapXdazM5sZrmRV0K1P0kfrkxScXcmSbCtBEvTQk6HdIfkN+fEj10tTUMwDN8LemZF53pAbn8Aj7xzlAthK5QP/ifoayBWNZycgFQqwY2EUiiAVpZPkhPPu6NT6+QBekrTBRUAHP75+9hQaLAnmFQUCdgXPuGjRRsjRbdsTtJFdqW45wOmbkzG8RWtJ4wbflhX8+hJyXxD4AAVRA5bdBcwo8LSPPzCZaTBgTUIhmtG75d49X1cE4xPw0wTehxIdx2RqMsN6okGpTGYc1mRGZvvEuDCZCfSh5UCFGUloKTMxr6hGM1oaWTRqESWwK81qlS07hx9aCosrjzH3Dd3g6DrOdHINFfOcYgS1oijm9sCZIdfWZvTO+IYcF+ZMfU+xtaL36Z7dii5QbLyL9D45/RSUelBBri2hoJgsPgWiVnMXYHpyK7zcMjl5zzdV4lChO7sDkA4kpOBAubxvA39S0DcvxyAe5hXnVYq9ScycrYUJQfxMKFFQPl6TYwe+wQ8twQxtqz1FhQKqkZ0gO0huYEIyJ3I9wkQqQFd02UJrJ5hffA5I512+C3KKNl5HCZ2jPZAYo89VXAD7mkGkGFVZ5iyVCsr4BMRfkMs6uB5qFi7VJFBjcQEogvlFPAj+LNswPer7+/fu6Z9djBsVgzlNkoaZzOTeidZPndKlDCuprf64nevXKZI0sXe0Zmhyv1qtMlMRFkm8lua3o8eqZUfPk3XcjUOXWDdWQ52c/vK7We1Hemh9fhE77Z0GX8OENOGBXEGBCuBenKcaIgPu/1I9oSJTifWTP3QWkKWanMQMApUYCqs61KOOrKUSobqRJN0eCg/RD/Qqq0zlJqy1c2RKkufjk0fHbVJYwVIVej16XgQ/44IC3HmmLBVy6OSuikNNUvnePum7VGZkhrMHw0hhxjkN6VLIKUuGnot8uNxV7dUQu4h6/OaxcEK1h+61yUwbrBmZSqSJo+GwoNofYcMDLgM6GbA3Sv5dBy+CL9o8jcBb3HzMwyvBUlN4i3nsXu8DOdNb5W1gWbxSZnR0Pm74Z1pskRG7B/2I6xh21bPH29P+GmOPX4zhghZ7k34AyuSue3synO/4OYcuDNRtFJW9JtCUL6noOvm8wwjncMd5oeRAArJNOWgwp7sZ0KAc7LkdQW/43cK3QdNxdEGL788H2gAPCQOFxK/R0kzSr8c+1KiT5ae3r6/frZuqSVCgwRjX8DpPPWZtlR0QsMlgakfNYRdMad1lXOumKmnYTb2i0X7HPAkH1cha29g2jQ/yw1U9NyXhJ1ePdomwzaG922yM4M4/f/19F1i169WcCo4VFCgIdJlX6EpK2rm9OEHfStD0bTiAsagsR4hkp0fRzygQlw64UBLIIuvtcWIJ8kDpMdqYAULBJQtamHfrmwaL3nIBjS9AKK+ct75kihmQw0mqOYKjOViakVVCsRMKST4mbFkWyQm24mtMSpP7urGMLqeuYOl6gcrWpvtErRnCtLVWmVuwJJw1OkdBt0TLOblIWo51FzSYVwT3B/eu5Xw+nw8wvR74UA572zh8On50+sur0yO1WWVGWOxO8UB7p/B5qwK67i6VoK5e9+/d/3bwYPCN2jY+So1uG0/HuE7F4LTfwfcpvLyaSP+nJb7vojRiG4vsNEepKMt+ALwzswe9pnPaODZDwGRGx4DJzOja+p4mwVlmKh9FfSyXE4z0JtjVSh93y0yaDxyVMbfsL9tZv/OyX3Xuwse39hvvdaFavfkwSJpqRqabEZ8L48BafgDD/vr/dbDcsIcfwLC943+d+J+8kh/MzM53wJcD+7p7+iFe9Z8Nnwn5P9nUD8Bff1BcwT/THyENni9r1Vv/EXAjnPUq5RbbaNYw95RmdbbZ5BPG7pCuG41smV99Qqy2F90np6/NavUv120jPA==
sidebar_class_name: "get api-method"
info_path: docs/extensions-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"}>Authorisation Endpoint</h1>

<MethodEndpoint method={"get"} path={"/v3/service/extension/oidc/{organisationId}/auth"}></MethodEndpoint>



OpenID Connect authorization endpoint that initiates the authentication flow. Returns an HTML page where individuals can authenticate using their EUDI Wallet through QR code or deep link verification.

## Request

<details style={{"marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collapsed={false} open={true}><summary style={{}}><h3 className={"openapi-markdown__details-summary-header-params"}>Path Parameters</h3></summary><div><ul><ParamsItem className={"paramsItem"} param={{"description":"The ID of the organisation","in":"path","name":"organisationId","required":true,"schema":{"type":"string"}}}></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"}>Query Parameters</h3></summary><div><ul><ParamsItem className={"paramsItem"} param={{"in":"query","name":"scope","required":true,"description":"The scope of the access request","schema":{"type":"string","enum":["openid"],"default":"openid"}}}></ParamsItem><ParamsItem className={"paramsItem"} param={{"in":"query","name":"response_type","required":true,"description":"The type of response desired","schema":{"type":"string","enum":["code"],"default":"code"}}}></ParamsItem><ParamsItem className={"paramsItem"} param={{"in":"query","name":"client_id","required":true,"description":"The ID of the client","schema":{"type":"string"}}}></ParamsItem><ParamsItem className={"paramsItem"} param={{"in":"query","name":"redirect_uri","required":true,"description":"The URI to which the response will be sent","schema":{"type":"string"}}}></ParamsItem><ParamsItem className={"paramsItem"} param={{"in":"query","name":"state","required":true,"description":"An opaque value used to maintain state between the request and the callback","schema":{"type":"string"}}}></ParamsItem><ParamsItem className={"paramsItem"} param={{"in":"query","name":"nonce","required":false,"description":"A string value used to associate a client session with an ID token, and to mitigate replay attacks","schema":{"type":"string"}}}></ParamsItem></ul></div></details><div><div><ApiTabs label={undefined} id={undefined}><TabItem label={"200"} value={"200"}><div>

Returns a web 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"}}><li className={"schemaItem"}><summary style={{}}><strong>X-Frame-Options</strong><span style={{"opacity":"0.6"}}> any</span></summary><div><div style={{"marginTop":".5rem","marginBottom":".5rem"}}>

Blocks page from being rendered in HTML frame, iframe, embed, or object elements, regardless of the site attempting to do so.

</div></div></li></ul></details><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"text/html"} value={"text/html"}><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 style={{"marginTop":".5rem","marginBottom":".5rem","marginLeft":"1rem"}}>

string

</div></ul></details></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem></ApiTabs></div></div>