Instant reconciliation

Learn how to run reconciliation instantly.

Authorization

If set, the API uses an API key for authentication. Include the following header in your requests: X-blnk-key: <api-key>.

Replace <api-key> with your secret API key. Ensure the key is kept secure and not exposed in public repositories or client-side code.

See also: Secure your Blnk server

Body

external_transactions · array

Array of external transactions to be reconciled.

Show child attributes

id · string · required

Unique external transaction id.

amount · integer · required

The transaction amount.

reference · string · required

Unique transaction reference.

currency · string · required

ISO 4217 currency code.

description · string · required

Description/narration of the transaction.

date · string · required

Transaction date and time.

source · string · required

Origin of the transaction data.

strategy · string · required

Specifies the reconciliation strategy to be applied. Learn more: Reconciliation strategy. Supported values are:

• one_to_one: Used for a direct match between an internal transaction record in your Blnk Ledger and an external transaction record.
• one_to_many: Used when one external transaction represents multiple internal transactions (e.g., batch or split payments).
• many_to_one: Used when multiple external transaction records make up one internal transaction record (e.g., installment payments, ACH transfers, etc.).

dry_run · boolean · default: "false" · required

Indicates whether the reconciliation process should be executed as a test or not.

• true: Results are not stored in the ledger, treating it as a test.
• false: Results are stored in the ledger.

grouping_criteria · string · required

Specifies the field used to group records during reconciliation.

matching_rule_ids · array · required

Specifies the IDs of the matching rules to apply during the reconciliation process.

{
  "upload_id": "upload_8c700d1b-09c0-4ef4-9ab1-a0decf3d0aa3",
  "strategy": "one_to_many",
  "dry_run": false,
  "grouping_criteria": "reference",
  "matching_rule_ids": [
    "rule_890bdbc4-467f-4670-8424-5667e41daf29",
    "rule_a1b2c3d4-5678-90ef-ghij-klmnopqrstuv"
  ]
}

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.

---

Tip: Connect to Blnk Cloud to see your Core data.

You can view your transactions, manage identities, create custom reports, invite other team members to collaborate, and perform operations on your Core — all in one dashboard.

Check out Blnk Cloud →