API

Inject Transaction

Inject a transaction into the watch system for real-time risk evaluation.

POST/inject

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.

Body

amountnumberbody

The transaction amount to evaluate.

currencystringbody

The three-letter ISO currency code. For example, USD.

transaction_idstringbody

A unique identifier for the transaction. If not provided, Watch generates a UUID.

sourcestringbody

The source balance identifier.

destinationstringbody

The destination balance identifier.

descriptionstringbody

A free-form description of the transaction.

created_atstringbody

The transaction timestamp in ISO 8601 format. If not provided, Watch uses the current server time.

meta_dataobjectbody

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."
}