> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Objeto Institutions

## El objeto Institutions

Un `Institution` representa una institución financiera compatible con Fintoc, como un banco o una autoridad fiscal. La API devuelve este objeto cuando listas las instituciones disponibles para un país y un producto determinados.

El siguiente ejemplo muestra una lista de instituciones:

```json Institutions Object theme={null}
[
  {
    "id": "cl_banco_santander",
    "object_name": "institution",
    "country": "cl",
    "name": "Banco Santander",
    "products": [
      {
        "holder_type": "individual",
        "name": "payments"
      },
      {
        "holder_type": "individual",
        "name": "subscription"
      },
      {
        "holder_type": "individual",
        "name": "movements"
      },
      {
        "holder_type": "business",
        "name": "movements"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_banco_internacional",
    "object_name": "institution",
    "country": "cl",
    "name": "Banco Internacional",
    "products": [
      {
        "holder_type": "individual",
        "name": "payments"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_banco_estado",
    "object_name": "institution",
    "country": "cl",
    "name": "Banco Estado",
    "products": [
      {
        "holder_type": "individual",
        "name": "subscription"
      },
      {
        "holder_type": "individual",
        "name": "payments"
      },
      {
        "holder_type": "individual",
        "name": "movements"
      },
      {
        "holder_type": "business",
        "name": "movements"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_banco_scotiabank",
    "object_name": "institution",
    "country": "cl",
    "name": "Banco Scotiabank",
    "products": [
      {
        "holder_type": "business",
        "name": "movements"
      },
      {
        "holder_type": "individual",
        "name": "movements"
      },
      {
        "holder_type": "individual",
        "name": "subscription"
      },
      {
        "holder_type": "individual",
        "name": "payments"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_banco_bci",
    "object_name": "institution",
    "country": "cl",
    "name": "Banco BCI",
    "products": [
      {
        "holder_type": "individual",
        "name": "subscription"
      },
      {
        "holder_type": "individual",
        "name": "payments"
      },
      {
        "holder_type": "individual",
        "name": "movements"
      },
      {
        "holder_type": "business",
        "name": "movements"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_banco_bice",
    "object_name": "institution",
    "country": "cl",
    "name": "Banco BICE",
    "products": [
      {
        "holder_type": "business",
        "name": "movements"
      },
      {
        "holder_type": "individual",
        "name": "movements"
      },
      {
        "holder_type": "individual",
        "name": "payments"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_banco_hsbc",
    "object_name": "institution",
    "country": "cl",
    "name": "HSBC",
    "products": [
      {
        "holder_type": "individual",
        "name": "payments"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_banco_itau",
    "object_name": "institution",
    "country": "cl",
    "name": "Banco Itaú",
    "products": [
      {
        "holder_type": "individual",
        "name": "payments"
      },
      {
        "holder_type": "business",
        "name": "movements"
      },
      {
        "holder_type": "individual",
        "name": "movements"
      },
      {
        "holder_type": "individual",
        "name": "subscription"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_banco_security",
    "object_name": "institution",
    "country": "cl",
    "name": "Banco Security",
    "products": [
      {
        "holder_type": "business",
        "name": "payouts"
      },
      {
        "holder_type": "business",
        "name": "movements"
      },
      {
        "holder_type": "individual",
        "name": "payments"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_banco_falabella",
    "object_name": "institution",
    "country": "cl",
    "name": "Banco Falabella",
    "products": [
      {
        "holder_type": "individual",
        "name": "payments"
      },
      {
        "holder_type": "individual",
        "name": "subscription"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_banco_ripley",
    "object_name": "institution",
    "country": "cl",
    "name": "Banco Ripley",
    "products": [
      {
        "holder_type": "individual",
        "name": "payments"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_banco_consorcio",
    "object_name": "institution",
    "country": "cl",
    "name": "Banco Consorcio",
    "products": [
      {
        "holder_type": "individual",
        "name": "payments"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_banco_bbva",
    "object_name": "institution",
    "country": "cl",
    "name": "Banco BBVA",
    "products": [
      {
        "holder_type": "individual",
        "name": "payments"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_banco_coopeuch",
    "object_name": "institution",
    "country": "cl",
    "name": "Coopeuch / Dale",
    "products": [
      {
        "holder_type": "individual",
        "name": "payments"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_prepago_los_heroes",
    "object_name": "institution",
    "country": "cl",
    "name": "Prepago Los Héroes",
    "products": [
      {
        "holder_type": "individual",
        "name": "payments"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_tenpo",
    "object_name": "institution",
    "country": "cl",
    "name": "Tenpo",
    "products": [
      {
        "holder_type": "individual",
        "name": "payments"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_copec_pay",
    "object_name": "institution",
    "country": "cl",
    "name": "Copec Pay",
    "products": [
      {
        "holder_type": "individual",
        "name": "payments"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_mercado_pago",
    "object_name": "institution",
    "country": "cl",
    "name": "Mercado Pago",
    "products": [
      {
        "holder_type": "individual",
        "name": "payments"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_banco_de_chile",
    "object_name": "institution",
    "country": "cl",
    "name": "Banco de Chile",
    "products": [
      {
        "holder_type": "individual",
        "name": "movements"
      },
      {
        "holder_type": "business",
        "name": "movements"
      },
      {
        "holder_type": "individual",
        "name": "subscription"
      },
      {
        "holder_type": "individual",
        "name": "payments"
      }
    ],
    "type": "bank"
  },
  {
    "id": "cl_tapp_caja_los_andes",
    "object_name": "institution",
    "country": "cl",
    "name": "TAPP Caja los Andes",
    "products": [
      {
        "holder_type": "individual",
        "name": "payments"
      }
    ],
    "type": "bank"
  }
]
```

La siguiente tabla describe los atributos de una institución:

| Atributo      | Tipo                 | Descripción                                                                                                                                                                                                                                                                                   |
| :------------ | :------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`          | `string`             | Identificador único de la institución financiera. El identificador comienza con el código de país de la institución. Por ejemplo, `cl_banco_santander`.                                                                                                                                       |
| `object_name` | `string`             | Identificador del tipo de objeto. Siempre es `institution`. Este recurso devuelve `object_name` en lugar de la clave `object` que usan otros recursos de la API.                                                                                                                              |
| `country`     | `string`             | Identificador del país de la institución. Los países disponibles son `cl` y `mx`.                                                                                                                                                                                                             |
| `name`        | `string`             | Nombre oficial de la institución.                                                                                                                                                                                                                                                             |
| `products`    | `array` de `objects` | Productos disponibles para la institución. Cada producto contiene `name`, que identifica el producto: `payments`, `movements`, `subscription`, `tax_returns`, `income`, `charges`, o `payouts`. También contiene `holder_type`, que identifica el tipo de titular: `individual` o `business`. |
| `type`        | `string`             | Tipo de institución financiera. Los valores disponibles son `bank` y `fiscal_authority`.                                                                                                                                                                                                      |