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

# Link object

The Link Object represents a connection between a user and their financial institution, enabling access to account data and transaction information.

```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"
}
```

| Attribute             | Type      | Description                                                                                                                                                                                                     |
| :-------------------- | :-------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                  | `string`  | Unique identifier for the Link                                                                                                                                                                                  |
| `object`              | `string`  | Identifier for the type of object. Its value for `Links` will always correspond to `link`                                                                                                                       |
| `accounts`            | `array`   | Accounts associated to the `Link`. See the Account Object to see more details. This field will be `null` when appropriate.                                                                                      |
| `active`              | `boolean` | Indicates if the bank accounts of the `Link` are being updated or not                                                                                                                                           |
| `created_at`          | `string`  | `Link`'s creation date, using ISO 8601                                                                                                                                                                          |
| `holder_id`           | `string`  | Identifier of the owner of the accounts held under the Link. In Chile, it corresponds to a RUT. In Mexico, it corresponds to a RFC                                                                              |
| `holder_type`         | `string`  | Indicates whether the account owner is an `individual` or a `business`                                                                                                                                          |
| `institution`         | `object`  | Financial institution associated to the `Link`                                                                                                                                                                  |
| `last_time_refreshed` | `string`  | Last time the link was refreshed considering its bank accounts.                                                                                                                                                 |
| `link_token`          | `string`  | Token to be used to make requests for resources nested under a `Link` (for example, bank movements). This attribute will only be returned when creating a `Link`. After that, this field will always be `null`. |
| `mode`                | `string`  | Indicates whether the `Link` is in `live` mode or in `test` mode (for the sandbox)                                                                                                                              |
| `refresh_status`      | `string`  | Refresh status of the `Link`. Values can be: `idle`, `refreshing`, `partially_refreshing`, `interrupted`                                                                                                        |
| `status`              | `string`  | Indicates if the `Link` needs to be reconnected (`login_required`) or if it is being updated with no problems (`active`). If the `Link` has been desactivated, this value will correspond to `inactive`         |
| `username`            | `string`  | Name of the user for the bank's platform. In Chile, it always corresponds to a RUT.                                                                                                                             |