---
updatedAt: 2026-09-16T12:23:30.000Z
agentTools:
  projectIndex: https://docs.datanomik.com/llms.txt
---

# List Institutions

List all institutions

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "openbanking-api",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.datanomik.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/v1/institutions": {
      "get": {
        "summary": "List Institutions",
        "description": "List all institutions",
        "operationId": "v1institutions",
        "parameters": [
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "AR",
                "BR",
                "BO",
                "CO",
                "CH",
                "PY",
                "PE",
                "UY"
              ]
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "Institution Type",
            "schema": {
              "type": "string",
              "enum": [
                "BANK",
                "PI"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"content\": [\n        {\n            \"id\": \"f15d81eb-7f7c-4536-b57a-b65b03ebd78c\",\n            \"description\": \"Bradesco\",\n            \"country\": \"BR\",\n            \"name\": \"BRADESCO\",\n            \"type\": \"BANK\",\n            \"logo\": \"https://resources.datanomik.com/institutions/br/Bradesco.svg\",\n            \"enabled\": true,\n            \"widget_enabled\": true,\n            \"stage\": \"STABLE\",\n            \"images\": [\n                {\n                    \"id\": \"24fb9eb9-9fd0-40d7-9180-b0989b2ca634\",\n                    \"image_url\": \"https://resources.datanomik.com/contextual_help/br/bradesco/Bradesco.png\",\n                    \"position\": 1\n                }\n            ],\n            \"support_balance_history\": false\n        },\n        {\n            \"id\": \"034f4f06-68fc-44d1-bce4-e509b28c83f9\",\n            \"description\": \"Itau\",\n            \"country\": \"UY\",\n            \"name\": \"ITAU\",\n            \"type\": \"BANK\",\n            \"logo\": \"https://resources.datanomik.com/institutions/uy/Itau.svg\",\n            \"enabled\": true,\n            \"widget_enabled\": true,\n            \"stage\": \"STABLE\",\n            \"images\": [\n                {\n                    \"id\": \"4a0c7396-6580-499a-a2d6-95a48b6b6506\",\n                    \"image_url\": \"https://resources.datanomik.com/contextual_help/uy/itau/Itau.png\",\n                    \"position\": 1\n                }\n            ],\n            \"support_balance_history\": false\n        },\n    ],\n    \"first\": true,\n    \"last\": true,\n    \"page_number\": 0,\n    \"page_size\": 50,\n    \"total_elements\": 2,\n    \"total_pages\": 1\n}"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request. Invalid or missing parameters/body, or a business rule that rejects the request.",
            "content": {
              "application/json": {
                "examples": {
                  "BEAN_VALIDATION_ERROR": {
                    "value": "{\n    \"code\": 402,\n    \"type\": \"BEAN_VALIDATION_ERROR\",\n    \"message\": \"Invalid arguments for specific request. Please check details to satisfy validations\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\",\n    \"details\": [\n        \"linkId: must not be blank\"\n    ]\n}"
                  },
                  "TYPE_MISMATCH": {
                    "value": "{\n    \"code\": 454,\n    \"type\": \"TYPE_MISMATCH\",\n    \"message\": \"Type mismatch for parameter\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 402
                    },
                    "type": {
                      "type": "string",
                      "example": "BEAN_VALIDATION_ERROR"
                    },
                    "message": {
                      "type": "string",
                      "example": "Invalid arguments for specific request. Please check details to satisfy validations"
                    },
                    "traceId": {
                      "type": "string",
                      "example": "0af7651916cd43dd8448eb211c80319c"
                    },
                    "details": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "example": [
                        "linkId: must not be blank"
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"code\": 401,\n    \"type\": \"UNAUTHORIZED\",\n    \"message\": \"Invalid credentials\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 401,
                      "default": 0
                    },
                    "type": {
                      "type": "string",
                      "example": "UNAUTHORIZED"
                    },
                    "message": {
                      "type": "string",
                      "example": "Invalid credentials"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Forbidden. Source IP not whitelisted, credentials without the required scope, or trial period expired.",
            "content": {
              "application/json": {
                "examples": {
                  "IP_NOT_ALLOWED": {
                    "value": "{\n    \"code\": 632,\n    \"type\": \"IP_NOT_ALLOWED\",\n    \"message\": \"Source ip address not allowed.\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  },
                  "FORBIDDEN": {
                    "value": "{\n    \"code\": 403,\n    \"type\": \"FORBIDDEN\",\n    \"message\": \"Forbidden\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 632
                    },
                    "type": {
                      "type": "string",
                      "example": "IP_NOT_ALLOWED"
                    },
                    "message": {
                      "type": "string",
                      "example": "Source ip address not allowed."
                    },
                    "traceId": {
                      "type": "string",
                      "example": "0af7651916cd43dd8448eb211c80319c"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error. Unexpected error; report the `traceId` to support.",
            "content": {
              "application/json": {
                "examples": {
                  "INTERNAL_ERROR": {
                    "value": "{\n    \"code\": 500,\n    \"type\": \"INTERNAL_ERROR\",\n    \"message\": \"Unexpected error. Please contact support with the traceId.\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 500
                    },
                    "type": {
                      "type": "string",
                      "example": "INTERNAL_ERROR"
                    },
                    "message": {
                      "type": "string",
                      "example": "Unexpected error. Please contact support with the traceId."
                    },
                    "traceId": {
                      "type": "string",
                      "example": "0af7651916cd43dd8448eb211c80319c"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```