Skip to main content
PATCH
Update an account number
v2 · Base URL https://api.fintoc.com/v2

Authorizations

Authorization
string
header
required

Path Parameters

id
string
required

Unique identifier of the account number to update.

Body

application/json
description
string

Free-text description of the account number.

Example:

"Updated description"

status
enum<string>

Status to apply to the account number. One of enabled (can receive inbound transfers) or disabled (cannot receive inbound transfers). You cannot set the blocked or deleted states through this endpoint.

Available options:
enabled,
disabled
Example:

"disabled"

metadata
object

Set of key-value pairs you can attach to the account number for storing additional structured information.

Example:
options
object

Inbound transfer constraints for this account number.

Response

The updated account number.

id
string
required

Unique identifier of the account number.

Example:

"acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN"

object
any
required

Type of the object. Always account_number.

account_id
string
required

Identifier of the account this number belongs to.

Example:

"acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA"

created_at
string<date-time>
required

Time the account number was created, as an ISO 8601 datetime in UTC.

Example:

"2026-03-01T12:00:00.000Z"

deleted_at
string | null
required

Time the account number was deleted, as an ISO 8601 datetime in UTC, or null when not deleted.

Example:

null

description
string | null
required

Free-text description of the account number, or null when none is set.

Example:

"Payouts CLABE"

is_root
boolean
required

Whether this account number is the account's default.

Example:

false

last_transfer_at
string | null
required

Time of the last transfer received, as an ISO 8601 datetime in UTC, or null when no transfer has been received.

Example:

null

metadata
object
required

Set of key-value pairs attached to the account number.

Example:
mode
enum<string>
required

Whether the account number holds live or test data.

Available options:
live,
test
Example:

"test"

number
string
required

Account number that receives inbound transfers. In Mexico, the 18-digit standardized Mexican bank account number (CLABE); in Chile, the bank account number.

Example:

"646180111800000000"

options
object
required

Inbound transfer constraints for this account number.

status
enum<string>
required

Current state of the account number. One of enabled (can receive inbound transfers), disabled (you turned off inbound transfers), blocked (Fintoc blocked inbound transfers), or deleted (removed; see deleted_at).

Available options:
enabled,
disabled,
blocked,
deleted
Example:

"enabled"

updated_at
string<date-time>
required

Time the account number was last updated, as an ISO 8601 datetime in UTC.

Example:

"2026-03-01T12:00:00.000Z"