Skip to main content
GET
/
balance-monitors
/
{monitor_id}
View balance monitor details
curl --request GET \
  --url http://localhost:5001/balance-monitors/{monitor_id} \
  --header 'X-blnk-key: <api-key>'
import requests

url = "http://localhost:5001/balance-monitors/{monitor_id}"

headers = {"X-blnk-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {'X-blnk-key': '<api-key>'}};

fetch('http://localhost:5001/balance-monitors/{monitor_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_PORT => "5001",
CURLOPT_URL => "http://localhost:5001/balance-monitors/{monitor_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-blnk-key: <api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "http://localhost:5001/balance-monitors/{monitor_id}"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("X-blnk-key", "<api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("http://localhost:5001/balance-monitors/{monitor_id}")
.header("X-blnk-key", "<api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("http://localhost:5001/balance-monitors/{monitor_id}")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)
request["X-blnk-key"] = '<api-key>'

response = http.request(request)
puts response.read_body
Use blnk.BalanceMonitor.get to retrieve a balance monitor by ID.
1

Call the method

blnk.BalanceMonitor.get
const response = await blnk.BalanceMonitor.get(
  'mon_e0e77b0c-4985-472a-9bf5-76a48b0259b0',
);
FieldTypeDescription
idstringMonitor ID to retrieve.
2

Use the monitor details

Read response.data for the threshold condition, webhook URL, and linked balance_id.
3

Response

200 OK
{
  "monitor_id": "mon_e0e77b0c-4985-472a-9bf5-76a48b0259b0",
  "balance_id": "bln_5ce86029-3c2e-4e2a-aae2-7fb931ca4c4f",
  "condition": {
    "field": "credit_balance",
    "operator": ">",
    "value": 1000,
    "precision": 100
  },
  "call_back_url": "https://api.example.com/balance-monitor",
  "description": "Low balance alert",
  "created_at": "2024-02-20T05:56:58.257315054Z"
}
FieldTypeDescription
monitor_idstringUnique ID for the monitor.
balance_idstringBalance being monitored.
conditionobjectThreshold rule for the monitor.
condition.fieldstringBalance field to watch (for example credit_balance, debit_balance, balance).
condition.operatorstringComparison operator: >, <, =, !=, >=, <=.
condition.valuenumberThreshold amount.
condition.precisionnumberCurrency precision (for example 100 for cents).
call_back_urlstringWebhook URL for notifications.
descriptionstringDescription for the monitor.
created_atstringDate and time when the monitor was created.

Balance monitoring

Conditions and webhook behavior.

View balance monitor details

HTTP request and response schema.

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.