---
id: service-read-organisation
title: "Read organisation"
description: "This endpoint is used to read the organisation information as configured by the organisation in the consent building block. This is used, for e.g., in the privacy dashboard."
sidebar_label: "Read organisation"
hide_title: true
hide_table_of_contents: true
api: eJzdWM1u20YQfpXBnhKAlhw3vQhBUMd2AzVBYsQxcggMeMQdURsvd5ndpWRF4K1P0kfrkxSzpCiSUmCnBQq0PtiUODM7Oz/ffOONkFQ4SjGQFJM5ak+JkORTp4qgrBET8XGhPJCRhVUmgPJQepIQLDhCCWFBYF2GRnlkBVBmbl1eP6OH1Jq5ykpHEmbrQ9Lxu9QaTybArFRaKpPBTNv0bgTx7ObIBObWAY2yUbJVK5xaYroGiX4xs+jkSCTCFuSi8akUE+HJLVVKHwjl+87BIhEFOswpkPNi8nkzuPS1UV9Lguk52Dmg6TktEqFYZkEoyYlEGMxJTEQt8217diIcfS2V48AGV1IifLqgHMVkI8K6YA0fnDKZqKobFvYFR8Hz+5PjY/6TWhPIBH7EotAqjbbHXzz7uOnYKxzfOqhau+fsZCNUoDy+QK3fz+NtGwfs7Auloefq5/o6idA23V63G5tEFFardH3ttEgElmFBJjSeiZtk4IqS+9cdFlg3LzA9F9U2og8pvsOcOD/DqmILPckHPVhyldAqVtgha57SYN3Dhq5quaoTvQd13m4lq25oH1S7jKLAstVeHib7Ge5rn/bkIaewsHLXrW2P9JJZoPcr6+Qh831JMjjT1BWcWasJjaiqKhFWyfSyMabJ+39kkGOdKXPpiCEken5Oc2XUFgMeiuT0vM170TECsrXCaDejGvhYNB4IS3JqrnbJ08rcKZP9q47UR0aVi+vzKXxCrSkMKsK6M0eSP6D+2x6lrYmuP9tZoLwvKcqp1w5NGCkLp10POvpcA/yT7Cc9qKBpAAkX98Gh36uI1C7JTXPM6DEXOWNpUCzeQMxO/1Ht1jVQ1j2nbWYf7cBbm9ne+a32o47vqMfTq+omdlIXt3ugdZMMghvFB7D3RiTNFOOQssDz42c/NHi655Nz1p1ZycMjPp93TtvzZ6/DW+1dMJQJlMURS/eYF1waz4+PqwPmDwSwVRGvUIIyRRmgnfl1DQ4Dcm24a6xT30juhebnH5zJ/6/QTE0gZ1ADEypyEI8ZxKgelKVTYR1Jxmmh3hA/3nCvvyJ05BgU4jd8a8yYe/W6naNRTyMxERnFYCCriHFD5cYDLlY7dIjEnVNuG39FIrhvJmIRQuEn47Gk3B5hoUYqa/BqvDwR7OdgogfMGGG/Y8bXrw9YutkF44prok7lNiRtTrD+4juU8rQpx0NEbCJOL6dwR2voD39mzQRL1GVLjm57dm6hPgby0gceJ4WjubonCSsVFnBb+wi38MTYUIN6cKh0DEOBKT1NIg0fmJ1Ao/hibUvHETm6o/XL2xGjXTf5GzGLn36Ne4KYiN8+fdy/W5qS9xDsHRlg4rF1r7bU+MyLQM8JaCMYGzEShagg2ibj1AmuVd5Uth2NaexoylFxen1ZFNaFX9qU7lLSzre9WtgJ73XPbig++fP3P57ySoNwtSKp/AIkBgS6TxdoMgI0sscsoCl7KJxdKkluBNPAc9eDJz0/8jyYSGUGVJyvYZ00+syYOmPXJ4AgVaYCalhFnhAP81YrCYWVEChdGMvkhnwCkXJxzhEMrUDTkjQXFCNPhCecKa3COhrBMlhe+kwGqc0LrdCkVCcsXs9RVup4H885Q5iXWnPlShWinzkaQ473N61SMj5i3bYLCkwXBCej472Yr1arEcbXI+uycaPrx2+nZxfvri6OWKfa8YoOObmcgrRpmW9ZlkgEw0idr5Pjk+ejn0bPak7uQ46m4w8vk8ONcLBvtFPiP7c+N10S6D6MC40qUtuy5ig1En/eLtW8bA+ge2F9YInNZoaeqU1V8ddfS3JxECRiiS5WZj0WtogXwVv5huQf+j9EN6ZPPjSz9Sk8sKgfvM0dI/D+uh4hU0xEnAK1DKNQETrv9kZ+1Z1Xry8+NjtxH+HvIsI3D531G826Y3sI9rUL/LtDlfsqL7iM39D6ZStev/muQguPtTTHg4nkX+0mVc8=
sidebar_class_name: "get api-method"
info_path: docs/consent-management-individual-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 organisation</h1>

<MethodEndpoint method={"get"} path={"/service/organisation"}></MethodEndpoint>



This endpoint is used to read the organisation information as configured by the organisation in the consent building block. This is used, for e.g., in the privacy dashboard.

## Request

<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":"Unique ID of an organisation","in":"header","name":"organizationId","required":true,"schema":{"type":"string"}}}></ParamsItem></ul></div></details><div><div><ApiTabs label={undefined} id={undefined}><TabItem label={"200"} value={"200"}><div>

OK

</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={"organisation"} required={true} schemaName={"object[]"} qualifierMessage={undefined} schema={{"items":{"allOf":[{"type":"object","required":["name","location","description","policyUrl","authentication"],"properties":{"id":{"type":"string","description":"Organisation ID"},"name":{"type":"string","description":"Name of the organisation"},"description":{"type":"string","description":"Overview for the organisation"},"sector":{"type":"string","description":"Sector"},"location":{"type":"string","description":"Location"},"policyUrl":{"type":"string","description":"Policy Url"},"authentication":{"type":"object","description":"Authentication methods configuration","properties":{"password":{"type":"object","properties":{"enabled":{"type":"boolean"}}},"oidcPasswordless":{"type":"object","properties":{"enabled":{"type":"boolean"},"loginPresentationDefinitionId":{"type":"string","description":"ID for the presentation definition to be used for login verification"},"linkingPresentationDefinitionId":{"type":"string","description":"ID for the presentation definition to be used for linking the EUDI Wallet"},"authenticatorCredentialDefinitionId":{"type":"string","description":"ID for the credential definition used to issue the iGrant.io Authenticator credential"}}}}}}},{"type":"object","title":"OrganisationExtras","properties":{"coverImageId":{"type":"string","description":"Cover image ID"},"coverImageUrl":{"type":"string","description":"Cover image url"},"logoImageId":{"type":"string","description":"Logo image ID"},"logoImageUrl":{"type":"string","description":"Logo image url"}}}]}}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"organisation\": [\n    {\n      \"id\": \"string\",\n      \"name\": \"string\",\n      \"description\": \"string\",\n      \"sector\": \"string\",\n      \"location\": \"string\",\n      \"policyUrl\": \"string\",\n      \"authentication\": {\n        \"password\": {\n          \"enabled\": true\n        },\n        \"oidcPasswordless\": {\n          \"enabled\": true,\n          \"loginPresentationDefinitionId\": \"string\",\n          \"linkingPresentationDefinitionId\": \"string\",\n          \"authenticatorCredentialDefinitionId\": \"string\"\n        }\n      },\n      \"coverImageId\": \"string\",\n      \"coverImageUrl\": \"string\",\n      \"logoImageId\": \"string\",\n      \"logoImageUrl\": \"string\"\n    }\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>