Documentation

Credit ledger

GET/v1/ledgerAccount

The account's latest 100 credit movements, newest first: monthly grants, top-ups, QR code runs and refunds. Free to call.

Example request

Terminal

curl "https://snip.link/v1/ledger" \
  -H "Authorization: Bearer $SNIP_KEY"

Example response

Response

{
  "entries": [
    {
      "id": "e1a2b3c4-5d6e-4f70-8a9b-0c1d2e3f4a5b",
      "kind": "grant",
      "delta": 10000,
      "note": "Monthly credits",
      "created_at": "2026-10-01T00:00:00.000Z"
    }
  ]
}

Response fields

Field	Type	Description
`entries`	object[]
`entries[].id`	string
`entries[].kind`	string	grant, topup, usage, refund or adjustment.
`entries[].delta`	integer	Credits added (positive) or spent (negative).
`entries[].note`	string, null
`entries[].created_at`	string

Errors

Status	Meaning
401	The API key is missing, malformed or revoked.
429	Either the key exceeded its requests-per-second limit (honor Retry-After), or a daily or plan quota is used up (`details.reason`).

Back to getting started