Skip to main content
POST
/
inject
curl -X POST http://localhost:8081/inject \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000.00,
    "currency": "USD",
    "transaction_id": "txn_ref_001",
    "source": "balance_123",
    "destination": "balance_456",
    "description": "High-value transfer",
    "created_at": "2026-03-16T09:00:00Z",
    "meta_data": {
      "merchant_category": "finance",
      "country": "US"
    }
  }'

{
  "transaction_id": "0f81a4e1-2b8d-496b-8d5d-a4e1e980f1a6",
  "message": "Call GET /transactions/{id} to fetch the processed transaction or set ALERT_WEBHOOK_URL to get webhooks when a rule triggers for the transaction."
}

Documentation Index

Fetch the complete documentation index at: https://docs.blnkfinance.com/llms.txt

Use this file to discover all available pages before exploring further.

When using Watch, use this endpoint to inject a transaction into the service for real-time risk evaluation.
Any extra Blnk attributes you want rules to use should be sent inside meta_data.
The field names match Blnk transaction naming — transaction_id, amount, currency, source, destination, created_at, meta_data — so mapping from Blnk Core stays predictable.

​
Body

​
amount
number
The transaction amount to evaluate.
​
currency
string
The three-letter ISO currency code. For example, USD.
​
transaction_id
string
A unique identifier for the transaction. If not provided, Watch generates a UUID.
​
source
string
The source balance identifier.
​
destination
string
The destination balance identifier.
​
description
string
A free-form description of the transaction.
​
created_at
string
The transaction timestamp in ISO 8601 format. If not provided, Watch uses the current server time.
​
meta_data
object
Additional metadata as key-value pairs. Use this to pass Blnk attributes needed by your rules.
curl -X POST http://localhost:8081/inject \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000.00,
    "currency": "USD",
    "transaction_id": "txn_ref_001",
    "source": "balance_123",
    "destination": "balance_456",
    "description": "High-value transfer",
    "created_at": "2026-03-16T09:00:00Z",
    "meta_data": {
      "merchant_category": "finance",
      "country": "US"
    }
  }'

{
  "transaction_id": "0f81a4e1-2b8d-496b-8d5d-a4e1e980f1a6",
  "message": "Call GET /transactions/{id} to fetch the processed transaction or set ALERT_WEBHOOK_URL to get webhooks when a rule triggers for the transaction."
}

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