Zad Top HTTP API
Connect your shop, website, or bot to the same redeem engine that runs @ZadTopBot. One key to authenticate, asynchronous redeem and check jobs, and a detailed result for every code.
Base URL
https://api.zadtop.com
Get a key
- Open @ZadTopBot → Subscription → HTTP API.
- Hold an active plan together with the API add-on — a fixed 15 USDT per 30 days, whatever the plan.
- Tap New API key. Creating a key revokes the previous one immediately.
Authentication
Send the key in an X-API-Key header on every request. Access pauses when either your plan or the API add-on expires, and resumes on renewal with the same key.
X-API-Key: pk_YOUR_KEY_HERE
How jobs work
Redeems and bulk checks are asynchronous. A POST validates your request and returns a job_id straight away; you then read the result from GET /v1/jobs/{id} — or add ?wait=25 so the request returns as soon as the job finishes, instead of polling.
A job reaching done does not mean every card succeeded. It means the work was carried out. The outcome of each card is in results[].success and, on failure, err_code.
curl -sS -X POST https://api.zadtop.com/v1/jobs/instant-redeem \
-H "X-API-Key: pk_YOUR_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{"player_id":"2186053213","codes":["4233939008625064"],"game":"freefire"}'
Check codes without redeeming
Each card comes back with a status — valid, used, invalid and a few more — and with with_value the pack it is worth. Nothing is redeemed, so a good card stays good.
curl -sS -X POST https://api.zadtop.com/v1/codes/check \
-H "X-API-Key: pk_YOUR_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{"codes":["7397062240255931","5539151276341494"],"with_value":true}'
Main routes
| POST | /v1/jobs/instant-redeem | Redeem Free Fire, PUBG, Yalla Ludo or Jawaker codes for a player ID. |
|---|---|---|
| POST | /v1/jobs/stock-redeem | Redeem from your stored stock by choosing packs. |
| POST | /v1/codes/check | Read up to 20 cards without redeeming them. |
| POST | /v1/jobs/code-check | The same check for up to 10,000 cards, as a job. |
| GET | /v1/player/lookup | The in-game name and region for a player ID. |
| GET | /v1/jobs/{id} | The state and result of one job. |
| GET | /v1/stock/summary | What you hold, per game and per pack. |
| POST | /v1/order/screenshot | The shop's order confirmation as a PNG. |
| GET | /v1/me · /v1/quota · /v1/history · /v1/players | Account, remaining allowance, past orders, saved players. |
| POST | /v1/subscription/purchase · purchase-api-addon | Buy or extend a plan from your USDT balance. |
| POST | /v1/subscription/purchase-check-code | Buy the Code checking subscription from your USDT balance. |
Games
The same routes serve every game — just change game. Packs and examples are in the API reference and on the game pages.
freefire | redeem · code check · player lookup |
|---|---|
pubg | redeem · code check · player lookup |
ludo / ludogold | redeem with tier · player lookup · Diamonds code check |
jawaker | redeem · player lookup · no code check |
itunes | balance check · value in value_label · no player, no redeem |
razer | PIN check · valid / used / invalid · no value · 5 requests per PIN |
razer_recharge | credits the PIN to your wallet · recharged / used / invalid · 5 requests per PIN |
Daily allowance
Every plan has a daily allowance that resets at midnight UTC and is shared by the games the plan covers. A redeem costs 1 request per code, a code check 1 per card, and a player lookup 0.25. A refusal from the shop counts; a failure on our side is returned to your allowance automatically. The bot and the API share one allowance.
Errors
Validation answers 400 with a code inside detail.error; authentication answers 401 or 403; too many calls answer 429. During a safe restart new jobs answer 503 SERVICE_DRAINING — retry shortly. The complete list of statuses, structured error codes, and per-code err_code values is in the full reference.
Request errors
| 401 | API key missing, mistyped or replaced by a newer key. Copy it again from the bot. | |
|---|---|---|
| 403 | No active plan with the API add-on. Renew in the bot. | |
| 403 | CHECK_CODE_SUBSCRIPTION_ONLY | Your key has the Code checking subscription only: it can check codes, not redeem them. |
| 403 | GAME_NOT_IN_PLAN | Your plan does not cover this game. Add the game to your plan in the bot. |
| 400 | INVALID_CODE | Not a valid code for this game. Nothing was sent or charged. |
| 400 | INVALID_PLAYER_ID | Not a valid player ID for this game. Nothing was sent or charged. |
| 400 | INSUFFICIENT_BALANCE | Your balance does not cover the price. Top up in the bot. |
| 429 | QUOTA_EXHAUSTED | Not enough requests left today. They refill at midnight UTC, or when you buy a plan. |
| 429 | RATE_LIMIT | Too many calls. Wait for the Retry-After seconds, then retry. |
| 503 | SERVICE_DRAINING | Short maintenance. Nothing was queued; retry in a few seconds. |
Per-card results (err_code)
CODE_ALREADY_USED | The card was already redeemed. Do not retry it. |
|---|---|
INVALID_CODE | The shop does not recognise the card. Check how it was typed. |
CODE_VOIDED | The code is invalid. The card issuer cancelled it. The attempt is charged. |
REGION_MISMATCH | The card is for another region than the player. |
PLAYER_NOT_FOUND | No account with this player ID. The cards were not used. |
NETWORK | A temporary problem before a result was known. Refunded; retry the same code. |
Regions
Players from almost every country are supported. Where Garena sells no vouchers at all — the United States, Argentina, Chile and Russia — a player lookup answers 422 UNSUPPORTED_REGION, before a single code is at risk.