Get paginated credit ledger history

curl --request POST \
  --url 'https://{domain}/wp-json/sagescreen/v1/wp-admin/admin-ajax.php?nonce=&action=sagescreen_get_credit_ledger' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data action=sagescreen_get_credit_ledger \
  --data 'nonce=<string>' \
  --data council_id=3c90c3cc-0d44-4b50-8888-8dd25736052a \
  --data page=1 \
  --data per_page=25

import requests

url = "https://{domain}/wp-json/sagescreen/v1/wp-admin/admin-ajax.php?nonce=&action=sagescreen_get_credit_ledger"

payload = {
    "action": "sagescreen_get_credit_ledger",
    "nonce": "<string>",
    "council_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "page": "1",
    "per_page": "25"
}
headers = {"Content-Type": "application/x-www-form-urlencoded"}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/x-www-form-urlencoded'},
  body: new URLSearchParams({
    action: 'sagescreen_get_credit_ledger',
    nonce: '<string>',
    council_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    page: '1',
    per_page: '25'
  })
};

fetch('https://{domain}/wp-json/sagescreen/v1/wp-admin/admin-ajax.php?nonce=&action=sagescreen_get_credit_ledger', 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://{domain}/wp-json/sagescreen/v1/wp-admin/admin-ajax.php?nonce=&action=sagescreen_get_credit_ledger",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "action=sagescreen_get_credit_ledger&nonce=%3Cstring%3E&council_id=3c90c3cc-0d44-4b50-8888-8dd25736052a&page=1&per_page=25",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/x-www-form-urlencoded"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://{domain}/wp-json/sagescreen/v1/wp-admin/admin-ajax.php?nonce=&action=sagescreen_get_credit_ledger"

	payload := strings.NewReader("action=sagescreen_get_credit_ledger&nonce=%3Cstring%3E&council_id=3c90c3cc-0d44-4b50-8888-8dd25736052a&page=1&per_page=25")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/x-www-form-urlencoded")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{domain}/wp-json/sagescreen/v1/wp-admin/admin-ajax.php?nonce=&action=sagescreen_get_credit_ledger")
  .header("Content-Type", "application/x-www-form-urlencoded")
  .body("action=sagescreen_get_credit_ledger&nonce=%3Cstring%3E&council_id=3c90c3cc-0d44-4b50-8888-8dd25736052a&page=1&per_page=25")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{domain}/wp-json/sagescreen/v1/wp-admin/admin-ajax.php?nonce=&action=sagescreen_get_credit_ledger")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/x-www-form-urlencoded'
request.body = "action=sagescreen_get_credit_ledger&nonce=%3Cstring%3E&council_id=3c90c3cc-0d44-4b50-8888-8dd25736052a&page=1&per_page=25"

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

{
  "success": true,
  "data": [
    {
      "id": 142,
      "date": "Feb 15, 2026 9:00 AM",
      "date_raw": "2026-02-15 09:00:00",
      "type": "Credit",
      "type_raw": "credit",
      "credit_type": "Credits",
      "credit_type_raw": "credits",
      "amount": "+100",
      "amount_raw": 100,
      "running_balance": 250,
      "expires_at": "Feb 15, 2027",
      "expires_at_raw": "2027-02-15 09:00:00",
      "reference_type": "order",
      "reference_id": "4821",
      "reference_label": "Order #4821",
      "reference_link": "/wp-admin/post.php?post=4821&action=edit",
      "notes": "Annual renewal",
      "action": "Renew (Auto)",
      "action_raw": "renew_auto",
      "reason": "",
      "reason_raw": null,
      "admin_notes": ""
    }
  ],
  "total": 47,
  "page": 1,
  "per_page": 25,
  "message": "Credit ledger retrieved successfully"
}

Billing – AJAX

Get paginated credit ledger history

Returns paginated credit/debit transactions from the council’s ledger table. Supports filtering by credit_type and pagination via page/per_page (or per_page=-1 for all records).

Council ID is auto-detected from session context or user meta. Non-admin users can only query their own council. The admin_notes field is only populated for users with administrator, ss_admin_all, or ss_power_user roles.

Registered as wp_ajax_sagescreen_get_credit_ledger — login required.

POST

wp-admin

admin-ajax.php?action=sagescreen_get_credit_ledger

Get paginated credit ledger history

curl --request POST \
  --url 'https://{domain}/wp-json/sagescreen/v1/wp-admin/admin-ajax.php?nonce=&action=sagescreen_get_credit_ledger' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data action=sagescreen_get_credit_ledger \
  --data 'nonce=<string>' \
  --data council_id=3c90c3cc-0d44-4b50-8888-8dd25736052a \
  --data page=1 \
  --data per_page=25

import requests

url = "https://{domain}/wp-json/sagescreen/v1/wp-admin/admin-ajax.php?nonce=&action=sagescreen_get_credit_ledger"

payload = {
    "action": "sagescreen_get_credit_ledger",
    "nonce": "<string>",
    "council_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "page": "1",
    "per_page": "25"
}
headers = {"Content-Type": "application/x-www-form-urlencoded"}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/x-www-form-urlencoded'},
  body: new URLSearchParams({
    action: 'sagescreen_get_credit_ledger',
    nonce: '<string>',
    council_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    page: '1',
    per_page: '25'
  })
};

fetch('https://{domain}/wp-json/sagescreen/v1/wp-admin/admin-ajax.php?nonce=&action=sagescreen_get_credit_ledger', 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://{domain}/wp-json/sagescreen/v1/wp-admin/admin-ajax.php?nonce=&action=sagescreen_get_credit_ledger",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "action=sagescreen_get_credit_ledger&nonce=%3Cstring%3E&council_id=3c90c3cc-0d44-4b50-8888-8dd25736052a&page=1&per_page=25",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/x-www-form-urlencoded"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://{domain}/wp-json/sagescreen/v1/wp-admin/admin-ajax.php?nonce=&action=sagescreen_get_credit_ledger"

	payload := strings.NewReader("action=sagescreen_get_credit_ledger&nonce=%3Cstring%3E&council_id=3c90c3cc-0d44-4b50-8888-8dd25736052a&page=1&per_page=25")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/x-www-form-urlencoded")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{domain}/wp-json/sagescreen/v1/wp-admin/admin-ajax.php?nonce=&action=sagescreen_get_credit_ledger")
  .header("Content-Type", "application/x-www-form-urlencoded")
  .body("action=sagescreen_get_credit_ledger&nonce=%3Cstring%3E&council_id=3c90c3cc-0d44-4b50-8888-8dd25736052a&page=1&per_page=25")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{domain}/wp-json/sagescreen/v1/wp-admin/admin-ajax.php?nonce=&action=sagescreen_get_credit_ledger")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/x-www-form-urlencoded'
request.body = "action=sagescreen_get_credit_ledger&nonce=%3Cstring%3E&council_id=3c90c3cc-0d44-4b50-8888-8dd25736052a&page=1&per_page=25"

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

{
  "success": true,
  "data": [
    {
      "id": 142,
      "date": "Feb 15, 2026 9:00 AM",
      "date_raw": "2026-02-15 09:00:00",
      "type": "Credit",
      "type_raw": "credit",
      "credit_type": "Credits",
      "credit_type_raw": "credits",
      "amount": "+100",
      "amount_raw": 100,
      "running_balance": 250,
      "expires_at": "Feb 15, 2027",
      "expires_at_raw": "2027-02-15 09:00:00",
      "reference_type": "order",
      "reference_id": "4821",
      "reference_label": "Order #4821",
      "reference_link": "/wp-admin/post.php?post=4821&action=edit",
      "notes": "Annual renewal",
      "action": "Renew (Auto)",
      "action_raw": "renew_auto",
      "reason": "",
      "reason_raw": null,
      "admin_notes": ""
    }
  ],
  "total": 47,
  "page": 1,
  "per_page": 25,
  "message": "Credit ledger retrieved successfully"
}

Authorizations

nonce

string

query

required

WordPress AJAX nonce (passed as form field, verified per-action)

Body

application/x-www-form-urlencoded

action

string

required

Allowed value: "sagescreen_get_credit_ledger"

nonce

string

required

WP nonce for sagescreen_frontend_nonce

council_id

string<uuid>

Council UUID (optional, auto-detected from session/user meta)

Example:

"c9d8e7f6-5a4b-3c2d-1e0f-a1b2c3d4e5f6"

page

integer

default:1

Page number (1-indexed)

Example:

1

per_page

integer

default:25

Results per page (max 100, or -1 for all)

Example:

25

credit_type

enum<string>

Type of credit in the ledger

Available options:

credits,

sage_credits

Example:

"credits"

Response

200 - application/json

Ledger result (check success field)

Option 1
Option 2

success

boolean

Example:

true

data

object[]

Show child attributes

total

integer

Total number of matching ledger rows

Example:

47

page

integer

Current page number

Example:

1

per_page

integer

Rows per page (or -1 when all rows returned)

Example:

25

message

string

Example:

"Credit ledger retrieved successfully"

Public API

Internal API

Get paginated credit ledger history

Authorizations

Body

Response