Reconciliation

Unreconcile reconciliation

Undoes the account’s latest reconciliation, the same as the Unreconcile button in Finta, so the period’s transactions can change again. Only the latest reconciled period can be undone; for an earlier one the error names the latest (not_latest_reconciliation with last_reconciliation_id). Send no body. Accounts with synced bank statements are reconciled again overnight if they still balance. Requires Reconciliation: Manage.

POST

/

reconciliations

/

{id}

/

unreconcile

Unreconcile reconciliation

curl --request POST \
  --url https://app.finta.com/api/v1/reconciliations/{id}/unreconcile \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.finta.com/api/v1/reconciliations/{id}/unreconcile"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.finta.com/api/v1/reconciliations/{id}/unreconcile', 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://app.finta.com/api/v1/reconciliations/{id}/unreconcile",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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://app.finta.com/api/v1/reconciliations/{id}/unreconcile"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.finta.com/api/v1/reconciliations/{id}/unreconcile")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "object": "reconciliation",
  "reconciled": true,
  "account_id": "<string>",
  "account_name": "<string>",
  "period_start": "2023-12-25",
  "period_end": "2023-12-25",
  "finta_balance_cents": 123,
  "statement_balance_cents": 123,
  "reconciled_at": 123,
  "reconciled_by": "<string>",
  "reconciled_via": "web_app"
}

Authorizations

Authorization

string

header

required

API key prefixed with finta_

Path Parameters

id

string

required

The period's recon_ ID, from GET /reconciliations.

Example:

"recon_3f9a1c27b84e4d0d9e6b5a2c71f08e44"

Response

The period, no longer reconciled.

id

string

required

Derived from the account, its ledger category and the period's end date, so it stays the same when the period is reconciled or undone.

Pattern: ^recon_[a-f0-9]{32}$

object

enum<string>

required

Available options:

reconciliation

reconciled

boolean

required

account_id

string

required

The acct_ ID, as in GET /accounts.

account_name

string | null

required

period_start

string<date>

required

period_end

string<date>

required

The calendar month's end, or the bank statement's date for statement-dated accounts.

finta_balance_cents

integer | null

required

What Finta's books add up to through period_end, in the statement's terms (a credit card's balance owed is positive). Null for a period reconciled as part of a later one.

statement_balance_cents

integer | null

required

The balance the period is checked against, entered by someone or supplied by a bank feed. Null until one is provided, and for a period reconciled as part of a later one.

reconciled_at

integer | null

required

When it was reconciled, in Unix seconds. Null until reconciled.

reconciled_by

string | null

required

The usr_ ID of who reconciled it. Null until reconciled, for the nightly job, and for reconciliations made before this was recorded.

reconciled_via

enum<string> | null

required

How a person reconciled it. Null on the same conditions as reconciled_by.

Available options:

web_app,

api,

mcp,

null

Unreconcile reconciliation

curl --request POST \
  --url https://app.finta.com/api/v1/reconciliations/{id}/unreconcile \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.finta.com/api/v1/reconciliations/{id}/unreconcile"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.finta.com/api/v1/reconciliations/{id}/unreconcile', 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://app.finta.com/api/v1/reconciliations/{id}/unreconcile",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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://app.finta.com/api/v1/reconciliations/{id}/unreconcile"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.finta.com/api/v1/reconciliations/{id}/unreconcile")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "object": "reconciliation",
  "reconciled": true,
  "account_id": "<string>",
  "account_name": "<string>",
  "period_start": "2023-12-25",
  "period_end": "2023-12-25",
  "finta_balance_cents": 123,
  "statement_balance_cents": 123,
  "reconciled_at": 123,
  "reconciled_by": "<string>",
  "reconciled_via": "web_app"
}