Instant reconciliation

POST

reconciliation

start-instant

curl --request POST \
  --url http://localhost:5001/reconciliation/start-instant \
  --header 'X-blnk-key: <api-key>'

import requests

url = "http://localhost:5001/reconciliation/start-instant"

headers = {"X-blnk-key": "<api-key>"}

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

print(response.text)

const options = {method: 'POST', headers: {'X-blnk-key': '<api-key>'}};

fetch('http://localhost:5001/reconciliation/start-instant', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "5001",
  CURLOPT_URL => "http://localhost:5001/reconciliation/start-instant",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "X-blnk-key: <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 := "http://localhost:5001/reconciliation/start-instant"

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

	req.Header.Add("X-blnk-key", "<api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("http://localhost:5001/reconciliation/start-instant")
  .header("X-blnk-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://localhost:5001/reconciliation/start-instant")

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

request = Net::HTTP::Post.new(url)
request["X-blnk-key"] = '<api-key>'

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

Use blnk.reconciliation().runInstant for this operation.

Call the method

String ruleId = "rule_073f7ffe-9dfd-42ce-aa50-d1dca1788adc";

ExternalTransaction external = ExternalTransaction.create()
    .id("ext_001")
    .amount(42.50)
    .reference("INV-001")
    .currency("USD")
    .description("Instant recon")
    .date("2025-02-15T10:30:00Z")
    .source("integration-test");

ApiResponse<JsonNode> response = blnk.reconciliation().runInstant(
    RunInstantReconData.create()
        .dryRun(true)
        .strategy("one_to_one")
        .matchingRuleIds(List.of(ruleId))
        .externalTransactions(List.of(external)));

Field	Type	Description
`external_transactions`	`List<` `ExternalTransaction>`	External transaction rows built with `ExternalTransaction.` `create()`.
`external_transactions.` `[].id`	`String`	Unique external transaction ID.
`external_transactions.` `[].amount`	`Number`	Transaction amount.
`external_transactions.` `[].reference`	`String`	Unique transaction reference.
`external_transactions.` `[].currency`	`String`	ISO 4217 currency code.
`external_transactions.` `[].description`	`String`	Description of the transaction.
`external_transactions.` `[].date`	`String`	Transaction date and time.
`external_transactions.` `[].source`	`String`	Origin of the transaction data.
`strategy`	`String`	Match strategy: `one_to_one`, `one_to_many`, or `many_to_one`.
`matching_rule_ids`	`List<String>`	IDs of the matching rules to apply.

Show Optional parameters

Field	Type	Description
`dry_run`	`boolean`	Set `true` to test without writing results to the ledger.
`grouping_criteria`	`String`	Field used to group records during matching.

Save the reconciliation ID

Use response.data().get("reconciliation_id").asText() with blnk.reconciliation().get to poll status and match counts.

Response

200 OK

{
  "reconciliation_id": "rec_a8f2c91d-1234-4abc-9def-0123456789ab"
}

Field	Type	Description
`reconciliation_id`	`String`	ID of the reconciliation run. Use it with `blnk.` `reconciliation().get` to check status.

How reconciliation works

Batch and instant reconciliation workflows.

HTTP request and response schema.

Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.

Start reconciliation

Get reconciliation

Start Here

Ledgers

Ledger balances

Transactions

Reconciliation

Identities

Metadata

Hooks

Search

API keys

System

Instant reconciliation

How reconciliation works