Skip to main content
GET
/
ledgers
/
{ledger_id}
Get ledger
curl --request GET \
  --url http://localhost:5001/ledgers/{ledger_id} \
  --header 'X-blnk-key: <api-key>'
import requests

url = "http://localhost:5001/ledgers/{ledger_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/ledgers/{ledger_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/ledgers/{ledger_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/ledgers/{ledger_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/ledgers/{ledger_id}")
.header("X-blnk-key", "<api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("http://localhost:5001/ledgers/{ledger_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.ledgers.get to retrieve a ledger by its ledger ID.
1

Call the method

blnk.ledgers.get
response = blnk.ledgers.get(
  "ldg_049495c6-356e-4ebc-a45e-60d1e1e16afb",
)
FieldTypeDescription
idstrLedger ID to retrieve.
2

Use the ledger details

Read response.data for the ledger name, metadata, and creation time. Use these values to confirm you have the correct ledger before creating balances or transactions.
3

Response

200 OK
{
  "ledger_id": "ldg_049495c6-356e-4ebc-a45e-60d1e1e16afb",
  "name": "Customer Checking Ledger",
  "created_at": "2024-11-26T08:23:57.509804Z",
  "meta_data": {
    "project_owner": "Blnk Tech"
  }
}
FieldTypeDescription
ledger_idstrUnique ID for the ledger.
namestrCurrent display name.
created_atstrDate and time the ledger was created.
meta_datadictMetadata object, if one was set at creation.

View ledger docs

Ledger concepts and setup.

View ledger 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.