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": "validation_failed",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "validation_failed",
    "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`, capped at `250`. `per_page` is accepted as an alias (`limit` wins when both are sent).
`offset`	int	No	Number of entries to skip for pagination. Defaults to `0`. `page` (1-based) is accepted as an alternative and is ignored when `offset` is given.

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.

page

integer

default:1

1-based page number (default 1). Ignored when offset is given.

Required range: x >= 1

per_page

integer

default:50

Page size (default 50, max 250). Alias of limit.

Required range: 1 <= x <= 250

limit

integer

Page size (default 50, max 250). Same as per_page; when both are sent limit wins.

Required range: 1 <= x <= 250

offset

integer

default:0

Row offset (default 0). Overrides the offset computed from page.

Required range: x >= 0

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": "validation_failed",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "validation_failed",
    "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