Endpoint
POST /reconciliation/upload
Request
This endpoint accepts multipart/form-data.
The file containing external transaction data. Supported formats:
- CSV: With headers for transaction fields
- JSON: Array of transaction objects
The file should include transaction details such as ID, amount, date, reference, and description The source identifier for the external data (e.g., “stripe”, “bank_statement”, “paypal”)
Response
Unique identifier for this upload. Use this ID to start a reconciliation process
The total number of transaction records found in the uploaded file
The source identifier provided in the request
Example Request
curl -X POST "https://api.blnk.io/reconciliation/upload" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@transactions.csv" \
-F "source=stripe"
id,amount,reference,currency,description,date,source
txn_ext_001,100.50,REF123,USD,Payment from customer,2024-03-04T10:00:00Z,stripe
txn_ext_002,250.00,REF124,USD,Subscription payment,2024-03-04T11:30:00Z,stripe
txn_ext_003,75.25,REF125,USD,One-time purchase,2024-03-04T14:15:00Z,stripe
[
{
"id": "txn_ext_001",
"amount": 100.50,
"reference": "REF123",
"currency": "USD",
"description": "Payment from customer",
"date": "2024-03-04T10:00:00Z",
"source": "stripe"
},
{
"id": "txn_ext_002",
"amount": 250.00,
"reference": "REF124",
"currency": "USD",
"description": "Subscription payment",
"date": "2024-03-04T11:30:00Z",
"source": "stripe"
}
]
Example Response
{
"upload_id": "upl_abc123def456",
"record_count": 3,
"source": "stripe"
}
Error Responses
Error message describing what went wrong
Common Errors
- 400 Bad Request: File upload failed or invalid file format
- 500 Internal Server Error: Failed to process the upload
Next Steps
After uploading external data:
- Create matching rules using the Create Matching Rule endpoint
- Start the reconciliation process using the Start Reconciliation endpoint with the
upload_id from this response
