OverviewAPI Reference
Billing

List ledger entries

Every movement of the balance, newest first: the welcome credit, top-ups, refunds, the daily keyword-day and mention debits, adjustments. A debit row carries the UTC day it settled and the cumulative units behind it. Cursor paged.

GET
/v1/billing/ledger

Authorization

AuthorizationBearer <token>

API key minted via POST /v1/api-keys (format mk_live_...)

In: header

Query Parameters

cursor?string

Opaque cursor from a previous page (nextCursor).

limit?integer

Page size, 1 to 100 (default 25).

Range1 <= value <= 100

Response Body

application/json

application/json

application/json

curl -X GET "https://api.mentio.dev/v1/billing/ledger"
{
  "data": [
    {
      "id": "string",
      "kind": "signup_credit",
      "amountCents": 0,
      "day": "string",
      "units": 0,
      "note": "string",
      "polarOrderId": "string",
      "createdAt": "string"
    }
  ],
  "nextCursor": "string"
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}

List receipts GET

The orders behind the top-ups, newest first, as the merchant of record (Polar) holds them: this workspace's share of the billing customer's newest 100 orders. Empty before the first top-up.

Get the workspace filters GET

The noise rules applied to every keyword before a mention is stored: excluded terms and authors, excluded GitHub repositories, and the subreddits Reddit posts may (or may not) come from. A post they reject is never classified, delivered or billed. Keyword-level rules live on each keyword (`matching`); both apply.