Meme LemurDocs

Prepaid credit

Pay ahead and get more credit than you paid. GET /v1/credits returns your team's balance, what was added to it, and the bonus each amount gets.

How prepaid credit works #

Your team can pay ahead. The operator, who is whoever runs Meme Lemur for you, adds the payment to your team as credit, and a bigger payment gets more credit than was paid.

You pay You get Bonus
Under $100 What you paid None
$100 or more 10% more $100 buys $110
$500 or more 12% more $500 buys $560
$2,000 or more 15% more $2,000 buys $2,300

The bonus is worked out on each payment by itself, so two payments of $250 get 10% each.

A request keeps its price. Each call you are charged for takes its price from the balance, in the same write that stores the call. A render and a failed call are free and take nothing. When the balance is above zero and smaller than the price of a call, the call takes what is left and the rest is billed.

Credit does not expire.

When the credit runs out #

The operator decides, for each team, what happens at a balance of zero. atZero in the response below says which applies to your team, and the operator can change it.

atZero At a balance of zero
refused Generate, match and regenerate return 402 until credit is added. A new team starts this way.
billed Your calls keep working, and they are billed at the standard price.

A refused call returns this body. It is not stored, and it is not charged:

JSON
{
  "error": "the team has no prepaid credit left, so the call was refused. An owner of the team should contact whoever runs Meme Lemur for the team to add credit",
  "details": { "reason": "noCredit", "balanceMicros": 0 }
}

Render, the library, settings and usage are free, and they keep working at zero.

The balance is read before a call runs. A call that starts with any credit left goes through, even when the balance is smaller than its price: it takes what is left and the rest is billed. Calls that start together on a nearly empty balance can therefore all go through, and the refusals begin with the first call after the balance reaches zero.

The owners of your team get an email when the balance goes under 20% of the last payment's credit, and another when it reaches zero. Each email says whether your calls are billed or refused at zero. To add credit, reply to either one.

Read the balance #

GET /v1/credits

Returns your team's balance, the entries that were added to it, newest first, and the bonus tiers. Any member can read it. Only the operator adds credit, so there is no route that changes it.

Query What it does
limit How many entries to return, from 1 to 100. Left out, it is 30.
offset How many entries to skip, for the next page. Left out, it is 0.
Shell
curl "https://api.memelemur.com/v1/credits?limit=2" \
  -H "Authorization: Bearer $MEMELEMUR_KEY"
JSON
{
  "balanceMicros": 96450000,
  "atZero": "refused",
  "tiers": [
    { "paidAtLeastMicros": 100000000, "bonusPercent": 10 },
    { "paidAtLeastMicros": 500000000, "bonusPercent": 12 },
    { "paidAtLeastMicros": 2000000000, "bonusPercent": 15 }
  ],
  "entries": [
    {
      "id": "crd_x1o2k9tq4m7w3b8e",
      "kind": "adjustment",
      "amountMicros": -5000000,
      "paidMicros": null,
      "bonusMicros": null,
      "note": "Refund",
      "createdAt": "2026-10-02T09:14:07.512Z"
    },
    {
      "id": "crd_c5h0r3n8d2y6u1va",
      "kind": "grant",
      "amountMicros": 110000000,
      "paidMicros": 100000000,
      "bonusMicros": 10000000,
      "note": "Invoice 1042",
      "createdAt": "2026-10-01T16:40:22.090Z"
    }
  ],
  "total": 2
}

Every amount is in micros, which are millionths of a US dollar, as whole numbers. 96450000 is $96.45.

Field What it is
balanceMicros The credit your team has left. It is never below zero.
atZero What happens to your calls at a balance of zero: refused or billed. See when the credit runs out.
tiers The bonus a payment gets. A payment of paidAtLeastMicros or more gets bonusPercent percent more credit, by the highest tier it reaches.
entries What was added to the balance. An entry is never changed or removed.
entries[].kind grant for a payment, or adjustment for a refund or a correction.
entries[].amountMicros What the entry did to the balance: the credit a grant gave, or the amount of an adjustment, which is negative when it took credit off.
entries[].paidMicros, entries[].bonusMicros What was paid for a grant, and the credit it gave over that. Null on an adjustment.
total How many entries your team has in all.

The calls that used the credit are not entries. Usage says how much of each day's cost credit covered, and each row of the feedback export says it for one call.

Errors #

Status When
400 limit or offset is out of range, or the query has a parameter this route does not take.