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

# Refresh intent object

## The Refresh Intent object

The `RefreshIntent` object represents a request to update a `Link` or an `Account` with the latest institution data, including movements. You create one to trigger a refresh. It reports whether the operation succeeded, failed, or requires multi-factor authentication (MFA).

```json Refresh Intent Object theme={null}
{
  "id": "ri_ml4K3O4RSvALRjnV",
  "object": "refresh_intent",
  "created_at": "2021-12-07T20:40:53.513Z",
  "new_movements": 0,
  "refreshed_object": "link",
  "refreshed_object_id": "link_aBcDeFgHiJkLmNoPqRsTuVwXyZ",
  "requires_mfa": null,
  "status": "succeeded",
  "type": "only_last"
}
```

| Attribute             | Type      | Description                                                                                                                                                                                                                            |
| :-------------------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                  | `string`  | Unique identifier for the Refresh Intent                                                                                                                                                                                               |
| `object`              | `string`  | Identifier for the type of object. Its value for `Refresh Intent` will always correspond to `refresh_intent`                                                                                                                           |
| `created_at`          | `string`  | Refresh Intent's creation date, using ISO 8601                                                                                                                                                                                         |
| `new_movements`       | `integer` | Amount of new movements (**since the last refresh**). It is only present when `refreshed_object` is `account`                                                                                                                          |
| `refreshed_object`    | `string`  | Indicates the type of refreshed object. It can correspond to `link` or `account`                                                                                                                                                       |
| `refreshed_object_id` | `string`  | Unique identifier for the refreshed object                                                                                                                                                                                             |
| `requires_mfa`        | `object`  | Corresponds to an object with a `widget_token` key. If present, the account requires `mfa` to refresh, so you need to open the widget with the `widget_token` given. If `null`, you don't need to open the widget to request a refresh |
| `status`              | `string`  | Indicates the status of the Refresh Intent. Possible values are `succeeded`, `failed` and `rejected`.                                                                                                                                  |
| `type`                | `string`  | Refresh scope. One of `historical`, which looks further back in time using the institution's historical statements, or `only_last`, which fetches the most recent movements, including ones Fintoc has not seen yet.                   |