SocialHz Engineering · 6 November 2026
A daily limit on a credit balance
GET /api/v1/me · GET /api/v1/credits
What shipped
A workspace with a credit balance can now also have a daily limit: the most it can spend on one platform in a day. The balance still never renews; the daily limit renews every day at midnight UTC. Your dashboard shows how much of today's limit you have used, next to the credits you have left.
Why
A balance meant to last, or shared by several people or jobs, could be spent in a single busy day. A daily limit spreads it out, so one heavy day doesn't leave nothing for the rest of the week.
How the two limits work together
- Each request needs room in both: the balance, and today's limit for that platform. Whichever has less left is what you can use now.
- The daily limit is per platform. Using today's limit on one platform leaves the others untouched.
- A workspace without a daily limit spends its balance at any pace, as before.
Reading it from the API
GET /api/v1/me includes plan.daily_cap when your balance has a daily limit. GET /api/v1/credits shows each platform's daily pool: daily.limit is the daily limit, daily.used what today has used, and remaining the smaller of what is left today and what is left of the balance. daily_resets_at says when the daily count starts again.
GET /api/v1/credits
{
"total": { "limit": 20000, "used": 6200, "remaining": 13800 },
"daily_resets_at": "2026-11-07T00:00:00Z",
"platforms": [
{
"name": "shopee",
"credits_per_request": 1,
"remaining": 1800,
"daily": { "limit": 5000, "used": 3200, "remaining": 1800 }
}
]
}When today's limit runs out
A run that needs more than is left today is refused with HTTP 429 and code daily_limit, and nothing is charged. While some credits are left, the message says how many, so you can fetch fewer records. Once they are all used, it says: "Today's credits for this platform are used up. They come back at midnight UTC." Your balance is untouched, and runs work again from midnight UTC.
Request a feature
Tell us what you need on the updates page. The engineering team reads every request.