Select Language

Choose your preferred language

Partner API Suite v1 live application/json

Free Fire Account API Reference

List our available Free Fire IDs on your website, reserve stock via API, and send buyers to ID Zone checkout. Catalog responses never include login passwords or account credentials.

Plans & limits

Choose a plan by contacting us (Messenger / TikTok / Telegram). After payment confirmation, admin activates your API key from the panel.

starter

Starter

$50/mo

  • 10,000 requests / month
  • 30 requests / minute
  • 2,000 soft daily guide
  • • Catalog sync
  • • Order reservation
  • • Email support
Contact to subscribe

growth

Growth

$100/mo

  • 50,000 requests / month
  • 60 requests / minute
  • 8,000 soft daily guide
  • • Everything in Starter
  • • Higher rate limits
  • • Priority support
  • • Webhook URL
Contact to subscribe

scale

Scale

$300/mo

  • 200,000 requests / month
  • 120 requests / minute
  • 30,000 soft daily guide
  • • Everything in Growth
  • • Highest throughput
  • • Dedicated onboarding
  • • IP allowlist
Contact to subscribe

Base URL

production origin — v1
https://idzone.top/api/v1

Authentication

Send your live key on every request. Keys look like idz_live_… and are stored hashed server-side.

Header Description
Authorization Bearer idz_live_… (preferred)
X-API-Key Alternative to Bearer.
Idempotency-Key Required on POST /orders.
X-Timestamp + X-Signature Optional HMAC-SHA256 of {timestamp}.{body} using your API secret (+ X-API-Secret).

Endpoints

GET /api/v1/catalog

Paginated available listings. Query: page, limit (max 100), server, min_price, max_price.

bash
curl -sS "https://idzone.top/api/v1/catalog?limit=20" \
  -H "Authorization: Bearer idz_live_xxxxxxxx" \
  -H "Accept: application/json"
{
  "success": true,
  "data": [
    {
      "id": 348,
      "title": "Level 72 — Mythic Bundle",
      "price_bdt": 12500,
      "currency": "BDT",
      "status": "available",
      "server": "BD",
      "level": 72,
      "bind_type": "Gmail",
      "thumbnail": "https://idzone.top/uploads/items/…",
      "url": "https://idzone.top/details.php?id=348"
    }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 120, "has_more": true }
}
GET /api/v1/catalog/{id}
Single available listing with safe detail fields (no credentials).
POST /api/v1/orders

Reserves an ID (prevents double-sell) and returns checkout_url on idzone.top. Hold expires in 45 minutes if unpaid.

bash
curl -sS -X POST "https://idzone.top/api/v1/orders" \
  -H "Authorization: Bearer idz_live_xxxxxxxx" \
  -H "Idempotency-Key: aca1352c7bc28b4c" \
  -H "Content-Type: application/json" \
  -d '{"item_id":123,"partner_order_id":"WS-1001","buyer":{"name":"Rahim","email":"rahim@example.com","phone":"01700000000"}}'
{
  "success": true,
  "data": {
    "id": "po_a1b2c3d4e5f67890",
    "item_id": 348,
    "status": "pending",
    "checkout_url": "https://idzone.top/details.php?id=348&po=…",
    "payment_instructions": "Complete payment on the ID Zone checkout page…",
    "expires_at": "2026-09-22 12:00:00"
  }
}
GET /api/v1/orders/{id}
Order status for your key only. Status: pending · completed · cancelled · expired.
GET /api/v1/me

Plan + remaining monthly quota for the calling key.

{
  "success": true,
  "data": {
    "key_prefix": "idz_live_abcd",
    "plan": { "name": "Growth", "slug": "growth", "price_usd": 100 },
    "quota": { "monthly_limit": 50000, "used": 120, "remaining": 49880, "resets_at": "…" },
    "rate_limit_per_minute": 60
  }
}
GET /api/v1/plans public · no auth
Returns active plan prices and limits (same data as this page).

Error model

{
  "success": false,
  "error": "Monthly request quota exceeded.",
  "code": "quota_exceeded"
}
401 — invalid / missing key
409 — item already reserved/sold
429 — rate limit or monthly quota
404 — unknown listing or order

Request API access

Submit this form, then contact us on Messenger/TikTok/Telegram to pick a $50 / $100 / $300 plan. Admin approves and issues your key.

Messenger YouTube TikTok Join Telegram Email Support