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:
{
"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. |
curl "https://api.memelemur.com/v1/credits?limit=2" \
-H "Authorization: Bearer $MEMELEMUR_KEY"{
"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. |