curl --request DELETE \
--url https://api.fintoc.com/v2/account_numbers/{id} \
--header 'Authorization: <api-key>'import requests
url = "https://api.fintoc.com/v2/account_numbers/{id}"
headers = {"Authorization": "<api-key>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {Authorization: '<api-key>'}};
fetch('https://api.fintoc.com/v2/account_numbers/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fintoc.com/v2/account_numbers/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fintoc.com/v2/account_numbers/{id}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.fintoc.com/v2/account_numbers/{id}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/account_numbers/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": "acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
"object": "account_number",
"account_id": "acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA",
"created_at": "2026-03-01T12:00:00.000Z",
"deleted_at": "2026-03-02T12:00:00.000Z",
"description": "Payouts CLABE",
"is_root": false,
"last_transfer_at": null,
"metadata": {
"invoice_id": "12345"
},
"mode": "test",
"number": "646180111800000004",
"options": {
"min_amount": 1000,
"max_amount": 1000000
},
"status": "deleted",
"updated_at": "2026-03-02T12:00:00.000Z"
}{
"error": {
"code": "invalid_params",
"message": "You cannot modify 'status' for Root Account Number: acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
}
}{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}{
"error": {
"code": "invalid_account_number",
"message": "Unable to delete account number acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN. Action not available in your region"
}
}{
"error": {
"code": "missing_resource",
"message": "Account Number not found: acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
}
}{
"error": {
"code": "blocked_account_number",
"message": "Account number acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN has been blocked. Contact soporte@fintoc.com for more information"
}
}Delete an account number
Deletes an account number of your organization. Available only for Mexico account numbers, which are standardized Mexican bank account numbers (CLABEs). You cannot delete the root account number. Returns the deleted account number. Deleting an account number that is already deleted is idempotent: the endpoint returns the account number again with its deleted status instead of an error. The endpoint returns 404 Not Found only when no account number with the given ID exists. The underlying CLABE becomes available in the recycling pool 30 days after deletion, and Fintoc may reassign the CLABE to a different account or organization. Deletion is permanent and cannot be undone.
curl --request DELETE \
--url https://api.fintoc.com/v2/account_numbers/{id} \
--header 'Authorization: <api-key>'import requests
url = "https://api.fintoc.com/v2/account_numbers/{id}"
headers = {"Authorization": "<api-key>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {Authorization: '<api-key>'}};
fetch('https://api.fintoc.com/v2/account_numbers/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fintoc.com/v2/account_numbers/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fintoc.com/v2/account_numbers/{id}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.fintoc.com/v2/account_numbers/{id}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/account_numbers/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": "acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
"object": "account_number",
"account_id": "acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA",
"created_at": "2026-03-01T12:00:00.000Z",
"deleted_at": "2026-03-02T12:00:00.000Z",
"description": "Payouts CLABE",
"is_root": false,
"last_transfer_at": null,
"metadata": {
"invoice_id": "12345"
},
"mode": "test",
"number": "646180111800000004",
"options": {
"min_amount": 1000,
"max_amount": 1000000
},
"status": "deleted",
"updated_at": "2026-03-02T12:00:00.000Z"
}{
"error": {
"code": "invalid_params",
"message": "You cannot modify 'status' for Root Account Number: acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
}
}{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}{
"error": {
"code": "invalid_account_number",
"message": "Unable to delete account number acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN. Action not available in your region"
}
}{
"error": {
"code": "missing_resource",
"message": "Account Number not found: acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
}
}{
"error": {
"code": "blocked_account_number",
"message": "Account number acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN has been blocked. Contact soporte@fintoc.com for more information"
}
}Authorizations
Path Parameters
Unique identifier of the account number to delete.
Response
The deleted account number.
Unique identifier of the account number.
"acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
Type of the object. Always account_number.
Identifier of the account this number belongs to.
"acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA"
Time the account number was created, as an ISO 8601 datetime in UTC.
"2026-03-01T12:00:00.000Z"
Time the account number was deleted, as an ISO 8601 datetime in UTC, or null when not deleted.
null
Free-text description of the account number, or null when none is set.
"Payouts CLABE"
Whether this account number is the account's default.
false
Time of the last transfer received, as an ISO 8601 datetime in UTC, or null when no transfer has been received.
null
Set of key-value pairs attached to the account number.
{ "invoice_id": "12345" }
Whether the account number holds live or test data.
live, test "test"
Account number that receives inbound transfers. In Mexico, the 18-digit standardized Mexican bank account number (CLABE); in Chile, the bank account number.
"646180111800000004"
Inbound transfer amount limits for this account number. Currently available for Mexico account numbers only.
Show child attributes
Show child attributes
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).
enabled, disabled, blocked, deleted "enabled"
Time the account number was last updated, as an ISO 8601 datetime in UTC.
"2026-03-01T12:00:00.000Z"
Was this page helpful?