Ledger balances

View balance monitor details

See the details of one or all balance monitors.

GET/balance-monitors/{monitor_id}

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.

Path

monitor_idstringrequiredpath

The unique id of the balance monitor you want to view. Leave empty to view all balance monitors in your Blnk Ledger.

Response

balance_idstring

Specifies the balance id of the ledger balance to be monitored.

conditionobject

Defines the criteria for monitoring a specific balance type.

Details

fieldstring

Specifies the balance type to be monitored. Every ledger balance has 6 balance types - balance, inflight_balance, credit_balance, inflight_credit_balance, debit_balance, and inflight_debit_balance.

operatorstring

Comparison applied: >, <, >=, <=, =, or !=.

valuenumber

Threshold in major units.

precisionnumber

Scale applied to value. A monitor created before precision existed is read as 1.

precise_valuenumber

Minor units Blnk compares against. value multiplied by precision.

triggerstring

edge or level. Monitors created before 0.15.7 are level.

condition_stateboolean

Last value of the condition. Present when trigger is edge. Omitted when trigger is level.

descriptionstring

A brief explanation of the purpose of the monitor.

created_atstring

Date and time when the monitor was created.

curl -X GET "http://localhost:5001/balance-monitors/{monitor_id}" \
  -H "X-blnk-key: <api-key>"

{
  "monitor_id": "mon_e0e77b0c-4985-472a-9bf5-76a48b0259b0",
  "balance_id": "bln_0be360ca-86fe-457d-be43-daa3f966d8f0",
  "condition": {
    "field": "debit_balance",
    "operator": ">",
    "value": 1000,
    "precision": 100,
    "precise_value": 100000
  },
  "description": "",
  "trigger": "edge",
  "condition_state": false,
  "created_at": "2024-02-20T05:56:58.257315054Z"
}

{
  "error": "Monitor with ID 'mon_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30' not found",
  "error_detail": {
    "code": "BAL_MONITOR_NOT_FOUND",
    "message": "Monitor with ID 'mon_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30' not found"
  }
}