List Ledger Entries

GET

ledger

entries

List ledger entries for an account

curl --request GET \
  --url https://billing.example.com/v1/ledger/entries \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://billing.example.com/v1/ledger/entries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://billing.example.com/v1/ledger/entries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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 := "https://billing.example.com/v1/ledger/entries"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://billing.example.com/v1/ledger/entries")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "debit_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "credit_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "amount": 1,
      "ledger_id": 123,
      "code": 123,
      "reference_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "description": "<string>",
      "timestamp": "2023-11-07T05:31:56Z"
    }
  ]
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "<string>"
  }
}

Query Parameters

Parameter	Type	Required	Description
`account_id`	string (uuid)	Yes	The ledger account whose postings to list — rows where it is either the debit or the credit side.
`code`	int	No	Filter to one posting code (e.g. `1` invoice, `3` payment, `6` tax reclass).
`limit`	int	No	Maximum number of entries to return. Defaults to `50`.
`offset`	int	No	Number of entries to skip for pagination. Defaults to `0`.

Each row is exactly one balanced transfer — a single debit account, a single credit account, and one amount in minor currency units. A business event that touches several accounts (an invoice with tax, say) posts several rows sharing the same reference_id. There is no date-range filter; results come back newest first, so page by limit/offset.

Example Request

curl "https://api.recurso.dev/v1/ledger/entries?account_id=e8f2d6b4-9a1c-4e7f-b3d5-6c8a0e2f4b19&code=3&limit=2" \
  -H "Authorization: Bearer $API_KEY"

Response

{
  "data": [
    {
      "id": "4c7e1a93-5b2d-4f6e-8a0c-9d3f5b7e1a24",
      "debit_account_id": "b3a1c9e7-2f4d-4a8b-9c6e-1d5f7a2b8c30",
      "credit_account_id": "e8f2d6b4-9a1c-4e7f-b3d5-6c8a0e2f4b19",
      "amount": 499900,
      "ledger_id": 1,
      "code": 3,
      "reference_id": "7d2b9f41-8c3e-4a5d-b6f0-1e4a7c9d2b58",
      "description": "Payment received",
      "created_at": "2026-06-16T14:30:00Z"
    },
    {
      "id": "9a2d5e71-3c8b-4f0e-a6d4-2b7f9c1e5a38",
      "debit_account_id": "b3a1c9e7-2f4d-4a8b-9c6e-1d5f7a2b8c30",
      "credit_account_id": "e8f2d6b4-9a1c-4e7f-b3d5-6c8a0e2f4b19",
      "amount": 26705,
      "ledger_id": 1,
      "code": 3,
      "reference_id": "5f8c2b96-1d4e-4a7c-9b3f-6e0a8d2c4f17",
      "description": "Payment received",
      "created_at": "2026-06-15T08:00:00Z"
    }
  ]
}

reference_id is the business object that caused the posting — the invoice for codes 1 and 6, the payment’s invoice for code 3, the credit note or wallet transaction for the credit and wallet codes.

Authorizations

Authorization

string

header

required

Tenant API key obtained from POST /auth/register or POST /v1/developer/keys.

Query Parameters

account_id

string<uuid>

required

code

integer

Filter to one posting code (e.g. 3 = payment). Omit for all.

limit

integer

Page size (default 50, max 250).

offset

integer

Response

Ledger transfers touching the account.

data

object[]

Show child attributes

List ledger entries for an account

curl --request GET \
  --url https://billing.example.com/v1/ledger/entries \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://billing.example.com/v1/ledger/entries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://billing.example.com/v1/ledger/entries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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 := "https://billing.example.com/v1/ledger/entries"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://billing.example.com/v1/ledger/entries")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "debit_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "credit_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "amount": 1,
      "ledger_id": 123,
      "code": 123,
      "reference_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "description": "<string>",
      "timestamp": "2023-11-07T05:31:56Z"
    }
  ]
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "<string>"
  }
}

Getting Started

Core

Billing & Invoicing

Revenue & Finance

Growth & Recovery

Compliance (India)

Platform

Customer Portal API

Query Parameters

Example Request

Response

Authorizations

Query Parameters

Response

​Query Parameters

​Example Request

​Response

Authorizations

Query Parameters

Response

Query Parameters

Example Request

Response