List links
Returns a paginated list of the links of your organization, in the live or test mode of the API key used. link_token and accounts are always null when listing links.
v1 · Base URL https://api.fintoc.com/v1
accounts field will be null when listing the Links. To see what accounts are associated to a Link, make a request to the Get link endpoint using its link_token.pageattribute.Authorizations
Query Parameters
If present, Fintoc returns only links with this status.
active, inactive, login_required Page number to retrieve. Starts at 1.
Number of links per page. Defaults to 30. The maximum is 300.
Response
Paginated list of links. The Link and X-Total-Count headers carry the pagination information.
Unique identifier of the link.
"link_nMNejK7BT8oGbvO4"
Type of the object. Always link.
Bank accounts of the link. Included when retrieving or exchanging a single link; null when listing or updating links.
Whether the link is active. Fintoc does not refresh inactive links. Deactivating a link stops refreshes but does not revoke the link_token's access to already-collected data.
true
ISO 8601 timestamp of when the link was created.
"2020-04-22T21:10:19.254Z"
Tax identifier of the account holder, without dots or hyphens (RUT in Chile, RFC in Mexico).
"111111111"
Whether the account holder is an individual or a business.
individual, business "individual"
ISO 8601 timestamp of the link's last refresh. null if Fintoc has never refreshed the link.
"2020-11-18T18:43:54.591Z"
Token used to authenticate requests for the link's resources. Only returned when the link is exchanged; null in every other response.
"link_nMNejK7BT8oGbvO4_token_sjnNsMyXKJEXAMPLETOKENrnNL1tA8"
Mode of the object. live objects use real institution data, test objects use fake data for integration testing.
test, live "live"
Refresh status of the link's accounts. idle means no refresh is in progress, refreshing means every account is refreshing, partially_refreshing means only some accounts are refreshing, and interrupted means no account is currently refreshing.
idle, refreshing, interrupted, partially_refreshing, null "idle"
Status of the link. login_required means the institution rejected the stored credentials and you must reconnect the link.
active, inactive, login_required "active"
Username used to log in at the institution, without dots or hyphens.
"111111111"
Identifier of the subscription associated to the link. Only present when the link is returned from a subscription exchange.
"sub_nMNejK7BT8oGbvO4"