OverviewPlatformsAPI Reference
Billing

List ledger entries

Shows the balance's history, latest first. Entries cover the welcome credit, top-ups, refunds, adjustments, and the daily keyword-day and mention debits. Debits carry their UTC settlement day and cumulative units. Cursor pages.

GET
/v1/billing/ledger

Authorization

bearerAuth
AuthorizationBearer <token>

An API key from POST /v1/api-keys. Keys start with ref_.

In: header

Query Parameters

cursor?string

The nextCursor of the previous page. Do not parse it.

limit?integer

How many to return, from 1 to 100, 25 by default.

Range1 <= value <= 100

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/billing/ledger"
{  "data": [    {      "id": "string",      "kind": "signup_credit",      "amountCents": 0,      "day": "string",      "units": 0,      "note": "string",      "polarOrderId": "string",      "createdAt": "string"    }  ],  "nextCursor": "string"}
Was this page helpful?

List receipts

Returns the top-up orders, latest first, as Polar, the merchant of record, stores them. You get this workspace's orders among the billing customer's latest 100. No orders exist before the first top-up.

Get the workspace filters

Returns the workspace noise rules, applied to every keyword before a mention is stored. They exclude terms, authors and GitHub repositories, and allow or block subreddits. Rejected posts are never classified, sent or billed. Keywords add their own `matching` rules on top.