Reconciliation

Reconcile reconciliation

Reconciles the period against the statement’s ending balance, the same as the Reconcile button in Finta. Finta’s balance must match it to the cent, or nothing is saved and the error carries both balances. The statement balance is required; a PDF isn’t. Reconciling locks the period: its transactions’ amounts, dates and deletions are blocked until it’s unreconciled, though categories can still change. It also reconciles any earlier unreconciled periods. Reconciling an already reconciled period is refused (already_reconciled), so a retry can’t reconcile twice. Requires Reconciliation: Manage.

POST

reconciliations

{id}

reconcile

Reconcile reconciliation

curl --request POST \
  --url https://app.finta.com/api/v1/reconciliations/{id}/reconcile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "statement_balance_cents": 123,
  "excluded_transaction_ids": [
    "<string>"
  ]
}
'

import requests

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

payload = {
    "statement_balance_cents": 123,
    "excluded_transaction_ids": ["<string>"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({statement_balance_cents: 123, excluded_transaction_ids: ['<string>']})
};

fetch('https://app.finta.com/api/v1/reconciliations/{id}/reconcile', 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}/reconcile",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'statement_balance_cents' => 123,
    'excluded_transaction_ids' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

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

	payload := strings.NewReader("{\n  \"statement_balance_cents\": 123,\n  \"excluded_transaction_ids\": [\n    \"<string>\"\n  ]\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.finta.com/api/v1/reconciliations/{id}/reconcile")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"statement_balance_cents\": 123,\n  \"excluded_transaction_ids\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"statement_balance_cents\": 123,\n  \"excluded_transaction_ids\": [\n    \"<string>\"\n  ]\n}"

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

string

required

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

Example:

"recon_3f9a1c27b84e4d0d9e6b5a2c71f08e44"

Body

application/json

statement_balance_cents

integer

required

The statement's ending balance in cents, as the statement prints it (a credit card's balance owed is positive).

excluded_transaction_ids

string[]

txn_ IDs to leave out of this period, such as a duplicate or an item that clears in a later period. Transactions posted after the statement's cutoff are always left out.

Response

The period, now reconciled.

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

Reconcile reconciliation

curl --request POST \
  --url https://app.finta.com/api/v1/reconciliations/{id}/reconcile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "statement_balance_cents": 123,
  "excluded_transaction_ids": [
    "<string>"
  ]
}
'

import requests

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

payload = {
    "statement_balance_cents": 123,
    "excluded_transaction_ids": ["<string>"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({statement_balance_cents: 123, excluded_transaction_ids: ['<string>']})
};

fetch('https://app.finta.com/api/v1/reconciliations/{id}/reconcile', 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}/reconcile",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'statement_balance_cents' => 123,
    'excluded_transaction_ids' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

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

	payload := strings.NewReader("{\n  \"statement_balance_cents\": 123,\n  \"excluded_transaction_ids\": [\n    \"<string>\"\n  ]\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.finta.com/api/v1/reconciliations/{id}/reconcile")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"statement_balance_cents\": 123,\n  \"excluded_transaction_ids\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"statement_balance_cents\": 123,\n  \"excluded_transaction_ids\": [\n    \"<string>\"\n  ]\n}"

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"
}

API Reference

Onboarding

Sheets

Taxes

Files

Company

Plans & billing

Team

Categories

Rules

Tags

Departments

Integrations

Inbox

Aggregations

Transactions

Forms

Reconciliation

Journal Entries

Invoices

Parties

Reports

Feedback

Tax Credits

Reconcile reconciliation

Authorizations

Path Parameters

Body

Response