POST
/
reconciliation
/
start
{
  "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"
  ]
}

​
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

​
upload_id
string

Defines the unique ID of the file containing the external data to be reconciled. Used for Batch Reconciliation.

​
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.