Skip to main content
GET
/
v1
/
billing
/
transactions
Credit Transactions
curl --request GET \
  --url https://api.example.com/v1/billing/transactions
The company-scoped credit ledger: one row per credit movement — deductions (negative amount) from billable operations and grants/top-ups (positive amount) — newest first. Powers the dashboard billing usage table.

​
Query parameters

ParamTypeDefaultNotes
limitnumber20Page size, clamped to 1–100.
offsetnumber0Rows to skip (for pagination).

​
Response

{
  "transactions": [
    {
      "id": "txn_…",
      "amount": -4,
      "action_type": "browser.signup",
      "reference_id": "…",
      "metadata": { "service": "figma.com" },
      "created_at": "2026-06-05T12:00:00.000Z"
    },
    {
      "id": "txn_…",
      "amount": 50,
      "action_type": "topup",
      "reference_id": "medium",
      "metadata": null,
      "created_at": "2026-06-04T09:30:00.000Z"
    }
  ],
  "total": 128,
  "limit": 20,
  "offset": 0
}
amount is negative for charges and positive for credits added. total is the full count for pagination. For a rolled-up usage summary instead of the raw ledger, see Usage.