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

Un `Link` representa la conexión entre un usuario final y una institución financiera. Esta conexión otorga acceso a las cuentas bancarias que el usuario tiene en esa institución. Fintoc crea el `Link` cuando el usuario completa el flujo del Fintoc Widget. El `Link` agrupa los objetos `Account` asociados y su estado de actualización.

```json Link Object theme={null}
{
    "id": "link_nMNejK7BT8oGbvO4",
    "object": "link",
    "accounts": [
        {
            "id": "acc_Z6AwnGn4idL7DPj4",
            "object": "account",
            "balance": {
              "available": 7010510,
              "current": 7010510,
              "limit": 7510510
            },
            "currency": "CLP",
            "holder_id": "111111111",
            "holder_name": "Test Customer 1",
            "name": "Cuenta Corriente",
            "number": "0000000000",
            "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": "111111111",
            "holder_name": "Test Customer 1",
            "name": "Línea de Crédito",
            "number": "00000000000",
            "official_name": "Linea De Credito Personas",
            "type": "line_of_credit"
        }
    ],
    "active": true,
    "created_at": "2020-04-22T21:10:19.254Z",
    "holder_id": "111111111",
    "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": "111111111"
}
```

El objeto `Link` incluye los siguientes atributos:

| Atributo              | Tipo      | Descripción                                                                                                                                                                                                                                                             |
| --------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                  | `string`  | Identificador único del `Link`.                                                                                                                                                                                                                                         |
| `object`              | `string`  | Identificador del tipo de objeto. Siempre es `link`.                                                                                                                                                                                                                    |
| `accounts`            | `array`   | Cuentas asociadas al `Link`. Consulta el [Objeto Account](/es/api/movements-api/accounts/accounts-object) para obtener más detalles. Fintoc incluye este campo cuando intercambias un `link_token` o consultas un `Link`; devuelve `null` cuando listas objetos `Link`. |
| `active`              | `boolean` | Si es `true`, las cuentas bancarias del `Link` se están actualizando.                                                                                                                                                                                                   |
| `created_at`          | `string`  | Fecha y hora de creación del `Link` en formato ISO 8601 y UTC.                                                                                                                                                                                                          |
| `holder_id`           | `string`  | Identificador del titular de las cuentas asociadas al `Link`. En Chile, es el identificador tributario chileno (RUT). En México, es el Registro Federal de Contribuyentes (RFC).                                                                                        |
| `holder_type`         | `string`  | Tipo de titular de la cuenta: `individual` para personas naturales o `business` para empresas.                                                                                                                                                                          |
| `institution`         | `object`  | Institución financiera asociada al `Link`, identificada por `id`, `country` y `name`.                                                                                                                                                                                   |
| `last_time_refreshed` | `string`  | Fecha y hora de la actualización más reciente del `Link` y sus cuentas, en formato ISO 8601 y UTC.                                                                                                                                                                      |
| `link_token`          | `string`  | Token para solicitar recursos anidados bajo un `Link`, como movimientos bancarios. Fintoc solo devuelve este atributo al crear un `Link`. En respuestas posteriores, este campo siempre es `null`.                                                                      |
| `mode`                | `string`  | Modo del `Link`: `live` o `test`. Usa `test` para el sandbox.                                                                                                                                                                                                           |
| `refresh_status`      | `string`  | Estado de actualización del `Link`: `idle`, `refreshing`, `partially_refreshing` o `interrupted`.                                                                                                                                                                       |
| `status`              | `string`  | Estado operativo del `Link`: `active` si se actualiza sin problemas, `login_required` si necesita una reconexión o `inactive` si fue desactivado.                                                                                                                       |
| `username`            | `string`  | Nombre de usuario para la plataforma del banco. En Chile, siempre es un RUT.                                                                                                                                                                                            |

<br />