List refresh intents
Returns a paginated list of the refresh intents of a link, most recent first, using the link’s link_token to authenticate the request.
v1 · Base URL https://api.fintoc.com/v1Authorizations
Query Parameters
The link_token of the link that holds the refresh intents to list, obtained when you exchanged the link.
"link_Q0xVGPvijElLRMwE_token_FhsFVurz5q5FycHA5xxhTpzX"
Page number to retrieve. Starts at 1.
Number of refresh intents per page. Defaults to 30. The maximum is 300.
Response
Paginated list of refresh intents. The Link and X-Total-Count headers carry the pagination information.
Unique identifier of the refresh intent.
"ri_2dXqkOKkS9mOvnaW"
Type of the object. Always refresh_intent.
ISO 8601 timestamp of when the refresh intent was created.
"2021-08-23T18:22:46.792Z"
Reason for the failure. retryable_error means you can retry the refresh, support_required_error means you need to contact Fintoc support. null unless status is failed.
retryable_error, support_required_error, null null
Type of the object being refreshed. The refresh intents API always returns link refresh intents.
link, account "link"
Identifier of the object being refreshed.
"link_nzwA3XWYiZkg4ojK"
Present when the institution requires multi-factor authentication to complete the refresh; contains the widget_token needed to resume the flow in the widget. null otherwise. Only included when refreshed_object is link.
Status of the refresh intent. rejected means the institution rejected the stored credentials.
created, waiting_for_action, requires_action, processing_action, rejected, failed, succeeded, canceled "succeeded"
Type of the refresh. only_last fetches the most recent movements, historical fetches the full history of movements.
only_last, historical "only_last"
Number of new movements the refresh fetched. Only present when refreshed_object is account (for example, in webhook payloads).
12