---
title: Get Institution List
slug: connect/get-institution-list
docTags: 
createdAt: 2023-11-21T06:36:48.089Z
---

:::ApiMethodV2
```json
{
  "name": "institutions",
  "method": "GET",
  "url": "https://api-sandbox.klavi.ai/data/v1/links/institutions",
  "description": "Get the list of participants(Open finance and open data) for the end user in the Link's context",
  "tab": "examples",
  "examples": {
    "languages": [
      {
        "id": "y0cyc73daVMqARFMBELFn",
        "language": "curl",
        "code": "curl --location 'https://api-sandbox.klavi.ai/data/v1/links/institutions' \\\n--header 'Accept: application/json' \\\n--header 'Content-Type: application/json'",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "y0cyc73daVMqARFMBELFn"
  },
  "results": {
    "languages": [
      {
        "id": "ua_EXge-oU6ICrmljFFwy",
        "language": "200",
        "customLabel": "",
        "code": "[\n    {\n        \"institutionCode\": \"341\",\n        \"name\": \"Itau\",\n        \"avatar\": \"https://avatarcredigo.s3.sa-east-1.amazonaws.com/banklogo/4d9277e5-6d8b-11ee-8c78-0a8b9f03afaa_of_itau.svg\",\n        \"isBeta\": false,\n        \"isOutage\": false,\n        \"institutionType\": 1,\n        \"businessType\": \"LEGAL\",\n        \"availableResources\":\n        [\n            \"REGISTRATION\",\n            \"ACCOUNTS\"\n        ],\n        \"parentOrganizationName\": \"\",\n        \"parentOrganizationId\": \"\",\n        \"organizationName\": \"ITAÚ UNIBANCO S.A.\",\n        \"organizationId\": \"9c721898-9ce0-50f1-bf85-05075557850b\"\n    },\n    {\n        \"institutionCode\": \"260\",\n        \"name\": \"Nubank\",\n        \"avatar\": \"https://avatarcredigo.s3.sa-east-1.amazonaws.com/banklogo/4d9277e5-6d8b-11ee-8c78-0a8b9f03afaa_of_nubank.svg\",\n        \"isBeta\": false,\n        \"isOutage\": false,\n        \"institutionType\": 1,\n        \"businessType\": \"LEGAL\",\n        \"availableResources\":\n        [\n            \"REGISTRATION\",\n            \"ACCOUNTS\"\n        ],\n        \"parentOrganizationName\": \"\",\n        \"parentOrganizationId\": \"\",\n        \"organizationName\": \"NU PAGAMENTOS S.A. - INSTITUIÇÃO DE PAGAMENTO\",\n        \"organizationId\": \"926e3037-a685-553c-afa3-f7cb46ff8084\"\n    }\n]"
      }
    ],
    "selectedLanguageId": "ua_EXge-oU6ICrmljFFwy"
  },
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [
      {
        "name": "Authorization",
        "kind": "required",
        "type": "string",
        "description": "Bearer link token, it returned by the /links",
        "children": []
      }
    ],
    "bodyDataParameters": [],
    "formDataParameters": []
  },
  "currentNewParameter": {
    "label": "Header Parameter",
    "value": "headerParameters"
  },
  "response": [
    {
      "name": "institutionCode",
      "kind": "optional",
      "type": "string",
      "description": "Institution identifier\nmaxLength: 4"
    },
    {
      "name": "name",
      "kind": "optional",
      "type": "string",
      "description": "Institution show name",
      "children": []
    },
    {
      "name": "avatar",
      "kind": "optional",
      "type": "string",
      "description": "Institution logo",
      "children": []
    },
    {
      "name": "isBeta",
      "kind": "optional",
      "type": "boolean",
      "description": "Beta status",
      "children": []
    },
    {
      "name": "isOutage",
      "kind": "optional",
      "type": "boolean",
      "description": "This flag indicates if there is any instability in the participant\ntrue: outage\nfalse: normal",
      "children": []
    },
    {
      "name": "institutionType",
      "kind": "optional",
      "type": "number",
      "description": "Institution type(1: Open finance 2: Open data)",
      "children": []
    },
    {
      "name": "businessType",
      "kind": "optional",
      "type": "string",
      "description": "The business type the participant accept, it is a NATURAL person only, LEGAL person only or BOTH, only when institutionType is 1\nBOTH - PJ & PF\nNATURAL - PF\nLEGAL - PJ",
      "children": []
    },
    {
      "name": "availableResources",
      "kind": "optional",
      "type": "array",
      "description": "Only when institutionType is 1\nREGISTRATION,\nACCOUNTS,\nCREDIT_CARDS,\nCREDIT_OPERATIONS:LOANS,\nCREDIT_OPERATIONS:FINANCINGS,\nCREDIT_OPERATIONS:UNARRANGED_ACCOUNTS_OVERDRAFT,\nCREDIT_OPERATIONS:INVOICE_FINANCINGS,\nINVESTMENTS:BANK_FIXED_INCOMES,\nINVESTMENTS:CREDIT_FIXED_INCOMES,\nINVESTMENTS:VARIABLE_INCOMES,\nINVESTMENTS:TREASURE_TITLES,\nINVESTMENTS:FUNDS",
      "children": []
    },
    {
      "name": "organizationId",
      "kind": "optional",
      "type": "string",
      "description": "The identifier of the organization",
      "children": []
    },
    {
      "name": "organizationName",
      "kind": "optional",
      "type": "string",
      "description": "The name of the organization",
      "children": []
    },
    {
      "name": "parentOrganizationId",
      "kind": "optional",
      "type": "string",
      "description": "The identifier of the parent organization",
      "children": []
    },
    {
      "name": "parentOrganizationName",
      "kind": "optional",
      "type": "string",
      "description": "The name of the parent organization",
      "children": []
    }
  ],
  "autoGeneratedAnchorSlug": "institutions",
  "legacyHash": "ITkc8xFzt27Pcj-WoPGKz"
}
```
:::