Skip to main content
POST
/
reconciliation
/
start-instant
Instant reconciliation
curl --request POST \
  --url http://localhost:5001/reconciliation/start-instant \
  --header 'X-blnk-key: <api-key>'
Use client.Reconciliation.RunInstant to reconcile external records inline.
1

Call the method

client.Reconciliation.RunInstant
txnDate := time.Date(2024, 11, 15, 14, 25, 30, 0, time.UTC)

instantResp, resp, err := client.Reconciliation.RunInstant(blnkgo.RunInstantReconData{
	ExternalTransactions: []blnkgo.ExternalTransaction{
		{
			ID: "txn_1",
			Amount: 5.49,
			Reference: "INV-2023-002",
			Currency: "GBP",
			Description: "Card payment",
			Date: &txnDate,
			Source: "bank-api",
		},
	},
	Strategy: blnkgo.ReconciliationStrategyOneToOne,
	DryRun: true,
	MatchingRuleIDs: []string{"rule_890bdbc4-467f-4670"},
})
FieldTypeDescription
ExternalTransactions[]blnkgo.ExternalTransactionArray of external transaction rows to reconcile.
ExternalTransactions[].IDstringUnique external transaction ID.
ExternalTransactions[].Amountfloat64Transaction amount.
ExternalTransactions[].ReferencestringUnique transaction reference.
ExternalTransactions[].CurrencystringISO 4217 currency code.
ExternalTransactions[].DescriptionstringDescription of the transaction.
ExternalTransactions[].Date*time.TimeTransaction date and time.
ExternalTransactions[].SourcestringOrigin of the transaction data.
Strategyblnkgo.ReconciliationStrategyMatch strategy: ReconciliationStrategyOneToOne, ReconciliationStrategyOneToMany, or ReconciliationStrategyManyToOne.
MatchingRuleIDs[]stringIDs of the matching rules to apply.
2

Save the reconciliation ID

Use instantResp.ReconciliationID with client.Reconciliation.Get to poll status and match counts.
3

Response

200 OK
{
  "reconciliation_id": "rec_a8f2c91d-1234-4abc-9def-0123456789ab"
}
FieldTypeDescription
reconciliation_idstringID of the reconciliation run. Use it with client.Reconciliation.Get to check status.

How reconciliation works

Batch and instant reconciliation workflows.

Instant reconciliation

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.