Skip to main content
POST
Close account

Authorizations

Authorization
string
header
required

An API key prefixed with finta_, or the access token from a Finta CLI browser login (finta login), prefixed with finta_oat_. A CLI login's access token lasts one hour and the CLI renews it itself.

Path Parameters

id
string
required

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

Example:

"recon_3f9a1c27b84e4d0d9e6b5a2c71f08e44"

Response

The period, with account_closed_on set.

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.

statement_file
object | null
required

The period's statement PDF, the one the Reconciliation page shows for it, whether someone uploaded it there, Finta fetched it from Mercury or Ramp, or it was attached with statement_file_id. Null when the period has none. Independent of statement_balance_cents. Retrieve the period again for a fresh download_url.

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
account_closed_on
string<date> | null
required

The date this period's account ledger was closed in Finta (see Close account), or null while it's open. An account reconnected onto a second ledger has periods in each, and each ledger closes on its own; the account's closed_on in GET /accounts is set once all of them are.