Reconciliation

Upload external records

Upload a CSV or JSON file of external records for reconciliation.

POST/reconciliation/upload

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.

Body

filefilerequiredbody

CSV, or a JSON array of records. A missing file returns 400 with RECON_UPLOAD_FAILED. A file Core cannot parse or store, including a duplicate id, returns 500 with RECON_UPLOAD_PROCESSING_FAILED.

sourcestringbody

Name copied onto every stored row, such as Stripe. A source column in the file is not kept.

Response

upload_idstringrequired

Id of the upload. Pass it as upload_id to Start reconciliation.

record_countintegerrequired

How many rows were stored.

sourcestringrequired

The source name you sent.

curl -X POST "http://localhost:5001/reconciliation/upload" \
  -H "X-blnk-key: <api-key>" \
  -F "[email protected]" \
  -F "source=Stripe"

{
  "upload_id": "upload_8c700d1b-09c0-4ef4-9ab1-a0decf3d0aa3",
  "record_count": 1000,
  "source": "Stripe"
}

{
  "error": "File upload failed",
  "error_detail": {
    "code": "RECON_UPLOAD_FAILED",
    "message": "File upload failed"
  }
}