Skip to main content
GET
Get an account
v1 · Base URL https://api.fintoc.com/v1

Authorizations

Authorization
string
header
required

Path Parameters

id
string
required

The id of the account to retrieve.

Query Parameters

The link_token of the link that holds the account, obtained when you exchanged the link.

Example:

"link_Q0xVGPvijElLRMwE_token_FhsFVurz5q5FycHA5xxhTpzX"

Response

The account.

id
string
required

Unique identifier of the account.

Example:

"acc_nMNejK7BT8oGbvO4"

object
any
required

Type of the object. Always account.

balance
object
required

Balance of the account, as reported by the institution. All amounts are in the smallest unit of the account's currency (CLP has no decimals, so amounts are in pesos).

currency
string
required

Three-letter ISO 4217 currency code of the account.

Pattern: ^[A-Z]{3}$
Example:

"CLP"

holder_id
string
required

Tax identifier of the account holder, without dots or hyphens (RUT in Chile, RFC in Mexico).

Example:

"111111111"

holder_name
string
required

Name of the account holder, as registered at the institution.

Example:

"Jon Snow"

name
string
required

Name of the account.

Example:

"Cuenta Corriente"

number
string
required

Number of the account, as registered at the institution.

Example:

"9530516286"

official_name
string
required

Commercial name of the account type, as defined by the institution.

Example:

"Cuenta Corriente Moneda Local"

refreshed_at
string<date-time> | null
required

ISO 8601 timestamp of the account's last refresh. null if Fintoc has never refreshed the account.

Example:

"2020-11-18T18:43:54.591Z"

type
enum<string>
required

Type of the account. Fintoc exposes RUT accounts as sight_account.

Available options:
checking_account,
savings_account,
sight_account,
line_of_credit,
credit_card
Example:

"checking_account"

next_refresh
string<date-time> | null

ISO 8601 timestamp of the next scheduled refresh of the account. Only present when the link has the movements product.

Example:

"2023-04-06T13:30:00.000Z"

refresh_status
enum<string>

Refresh status of the account. starting means the account was just connected and has not been refreshed yet, refreshing means a refresh is in progress, and interrupted means the account is not currently being refreshed. Only present when the link has the movements product.

Available options:
refreshing,
interrupted,
starting
Example:

"refreshing"

Whether the account no longer belongs to the link (for example, because the institution stopped returning the account). Only present when the link has the movements product.

Example:

false