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

Refresh Intent Object

{
  "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.

Fintoc API

Main Resources

Payments API

Transfers API

Movements API

Direct Debit (Legacy)

Fiscal API

Refresh intent object

The Refresh Intent object

​The Refresh Intent object

The Refresh Intent object