> ## 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 Link

El objeto Link representa una conexión entre un usuario y su institución financiera, permitiendo el acceso a los datos de las cuentas y a la información de transacciones.

```json theme={null}
{
  "id": "link_nMNejK7BT8oGbvO4",
  "object": "link",
  "accounts": [
    {
      "id": "acc_Z6AwnGn4idL7DPj4",
      "object": "account",
      "balance": {
        "available": 7010510,
        "current": 7010510,
        "limit": 7510510
      },
      "currency": "CLP",
      "holder_id": "134910798",
      "holder_name": "Jon Snow",
      "name": "Cuenta Corriente",
      "number": "9530516286",
      "official_name": "Cuenta Corriente Moneda Local",
      "type": "checking_account"
    },
    {
      "id": "acc_BO381oEATXonG6bj",
      "object": "account",
      "balance": {
        "available": 500000,
        "current": 500000,
        "limit": 500000
      },
      "currency": "CLP",
      "holder_id": "134910798",
      "holder_name": "Jon Snow",
      "name": "Línea de Crédito",
      "number": "19534121467",
      "official_name": "Linea De Credito Personas",
      "type": "line_of_credit"
    }
  ],
  "active": true,
  "created_at": "2020-04-22T21:10:19.254Z",
  "holder_id": "134910798",
  "holder_type": "individual",
  "institution": {
    "id": "cl_banco_de_chile",
    "country": "cl",
    "name": "Banco de Chile"
  },
  "last_time_refreshed": "2020-04-22T23:10:19.254Z",
  "link_token": "link_nMNejK7BT8oGbvO4_token_GLtktZX5SKphRtJFe_yJTDWT",
  "mode": "test",
  "refresh_status": "refreshing",
  "status": "active",
  "username": "183917137"
}
```

| Atributo              | Tipo      | Descripción                                                                                                                                                                                                              |
| :-------------------- | :-------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                  | `string`  | Identificador único del Link                                                                                                                                                                                             |
| `object`              | `string`  | Identificador del tipo de objeto. Su valor para los `Links` siempre corresponderá a `link`                                                                                                                               |
| `accounts`            | `array`   | Cuentas asociadas al `Link`. Consulta el objeto Account para ver más detalles. Este campo será `null` cuando corresponda.                                                                                                |
| `active`              | `boolean` | Indica si las cuentas bancarias del `Link` están siendo actualizadas o no                                                                                                                                                |
| `created_at`          | `string`  | Fecha de creación del `Link`, usando ISO 8601                                                                                                                                                                            |
| `holder_id`           | `string`  | Identificador del dueño de las cuentas que están bajo el Link. En Chile, corresponde a un RUT. En México, corresponde a un RFC                                                                                           |
| `holder_type`         | `string`  | Indica si el dueño de la cuenta es un `individual` o un `business`                                                                                                                                                       |
| `institution`         | `object`  | Institución financiera asociada al `Link`                                                                                                                                                                                |
| `last_time_refreshed` | `string`  | Última vez que el link fue actualizado considerando sus cuentas bancarias.                                                                                                                                               |
| `link_token`          | `string`  | Token que se usa para hacer solicitudes de recursos anidados bajo un `Link` (por ejemplo, los movimientos bancarios). Este atributo solo se devuelve al crear un `Link`. Después de eso, este campo siempre será `null`. |
| `mode`                | `string`  | Indica si el `Link` está en modo `live` o en modo `test` (para el sandbox)                                                                                                                                               |
| `refresh_status`      | `string`  | Estado de actualización del `Link`. Los valores pueden ser: `idle`, `refreshing`, `partially_refreshing`, `interrupted`                                                                                                  |
| `status`              | `string`  | Indica si el `Link` necesita ser reconectado (`login_required`) o si está siendo actualizado sin problemas (`active`). Si el `Link` ha sido desactivado, este valor corresponderá a `inactive`                           |
| `username`            | `string`  | Nombre del usuario para la plataforma del banco. En Chile, siempre corresponde a un RUT.                                                                                                                                 |