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

  1. Open @ZadTopBot → Subscription → HTTP API.
  2. Hold an active plan together with the API add-on — a fixed 15 USDT per 30 days, whatever the plan.
  3. 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-redeemRedeem Free Fire, PUBG, Yalla Ludo or Jawaker codes for a player ID.
POST/v1/jobs/stock-redeemRedeem from your stored stock by choosing packs.
POST/v1/codes/checkRead up to 20 cards without redeeming them.
POST/v1/jobs/code-checkThe same check for up to 10,000 cards, as a job.
GET/v1/player/lookupThe in-game name and region for a player ID.
GET/v1/jobs/{id}The state and result of one job.
GET/v1/stock/summaryWhat you hold, per game and per pack.
POST/v1/order/screenshotThe shop's order confirmation as a PNG.
GET/v1/me · /v1/quota · /v1/history · /v1/playersAccount, remaining allowance, past orders, saved players.
POST/v1/subscription/purchase · purchase-api-addonBuy or extend a plan from your USDT balance.
POST/v1/subscription/purchase-check-codeBuy 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.

freefireredeem · code check · player lookup
pubgredeem · code check · player lookup
ludo / ludogoldredeem with tier · player lookup · Diamonds code check
jawakerredeem · player lookup · no code check
itunesbalance check · value in value_label · no player, no redeem
razerPIN check · valid / used / invalid · no value · 5 requests per PIN
razer_rechargecredits 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

401API key missing, mistyped or replaced by a newer key. Copy it again from the bot.
403No active plan with the API add-on. Renew in the bot.
403CHECK_CODE_SUBSCRIPTION_ONLYYour key has the Code checking subscription only: it can check codes, not redeem them.
403GAME_NOT_IN_PLANYour plan does not cover this game. Add the game to your plan in the bot.
400INVALID_CODENot a valid code for this game. Nothing was sent or charged.
400INVALID_PLAYER_IDNot a valid player ID for this game. Nothing was sent or charged.
400INSUFFICIENT_BALANCEYour balance does not cover the price. Top up in the bot.
429QUOTA_EXHAUSTEDNot enough requests left today. They refill at midnight UTC, or when you buy a plan.
429RATE_LIMITToo many calls. Wait for the Retry-After seconds, then retry.
503SERVICE_DRAININGShort maintenance. Nothing was queued; retry in a few seconds.

Per-card results (err_code)

CODE_ALREADY_USEDThe card was already redeemed. Do not retry it.
INVALID_CODEThe shop does not recognise the card. Check how it was typed.
CODE_VOIDEDThe code is invalid. The card issuer cancelled it. The attempt is charged.
REGION_MISMATCHThe card is for another region than the player.
PLAYER_NOT_FOUNDNo account with this player ID. The cards were not used.
NETWORKA 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.