Reseller API ยท v1

Sell GhostLogs products on your own website

A simple REST API. List products, place orders paid from your GhostLogs wallet and get the logins back in the same reply. No waiting, no webhooks needed.

Base URLhttps://www.ghostlogs.org/api/v1

Getting started

  1. Request access. Go to My account โ†’ Reseller API and tell us about your website. We approve requests manually.
  2. Create your key. Once approved, create a key on the same page. It is shown once, so store it safely.
  3. Fund your wallet. Every API order is paid from your GhostLogs wallet balance. Approved resellers may get a discount on every product.
  4. Connect. Call the endpoints below from your server. Each order returns the logins straight away.

Authentication

Send your key in the Authorization header on every request. (X-API-Key: <key> also works.) All replies are JSON with a success field.

Header
Authorization: Bearer gl_live_xxxxxxxxxxxxxxxxxxxxxxxx
Never put your key in browser or app code. Anyone who sees it can spend your wallet. Call the API from your server only. If a key leaks, reset it on your API page and the old one stops working instantly.

Check balance

GET/api/v1/balance

Your current GhostLogs wallet balance in naira.

curl https://www.ghostlogs.org/api/v1/balance \
  -H "Authorization: Bearer $GHOSTLOGS_API_KEY"
Response
{
  "success": true,
  "data": { "balance": 25000, "currency": "NGN" }
}

List products

GET/api/v1/products

Everything you can buy, with your price (after any reseller discount) and live stock. Optional query: ?category=facebook, ?in_stock=true.

stock is how many are left. It is null when the supplier does not report stock: those products can still be bought, and an order that cannot be filled is refunded automatically. Supplier products refresh every minute; your own products are always live.

curl "https://www.ghostlogs.org/api/v1/products?in_stock=true" \
  -H "Authorization: Bearer $GHOSTLOGS_API_KEY"
Response
{
  "success": true,
  "data": {
    "discount_percent": 10,
    "count": 1,
    "products": [
      {
        "id": "6b0c3d4e-1a2b-4c5d-8e9f-0a1b2c3d4e5f",
        "name": "Facebook Account 0-100 Friends USA",
        "category": "facebook",
        "description": "Fresh USA account with email access",
        "badge": "HOT",
        "price": 2160,
        "retail_price": 2400,
        "currency": "NGN",
        "stock": 15
      }
    ]
  }
}

Place an order

POST/api/v1/orders

Buys the product with your wallet and returns the logins immediately. Send a JSON body:

FieldTypeDescription
product_idstring, requiredThe id from List products.
quantitynumber, 1โ€“100How many to buy. Default 1.
referencestring, optionalYour own order number (letters, numbers, - _ . :). Sending the same reference again returns the same order instead of charging twice. Strongly recommended.
curl -X POST https://www.ghostlogs.org/api/v1/orders \
  -H "Authorization: Bearer $GHOSTLOGS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"6b0c3d4e-1a2b-4c5d-8e9f-0a1b2c3d4e5f","quantity":1,"reference":"MYSHOP-1042"}'
Response ยท 201 Created
{
  "success": true,
  "data": {
    "id": "c1d2e3f4-5a6b-7c8d-9e0f-112233445566",
    "reference": "MYSHOP-1042",
    "status": "delivered",
    "total": 2160,
    "currency": "NGN",
    "balance_after": 22840,
    "items": [{ "product_id": "6b0cโ€ฆ4e5f", "quantity": 1, "unit_price": 2160 }],
    "credentials": [
      "Username: john_doe_22\nPassword: ********\nEmail: john22@mail.com"
    ]
  }
}
Each item in credentials is one complete login as plain text (it may contain line breaks). Show it to your customer exactly as received.
Partner products (ids starting with gl_) are bought live from a partner. Most arrive instantly (201, "status": "delivered"). If the supplier needs a moment you get 202 with "status": "processing" and no logins yet: call Get an order every 5โ€“10 seconds until it is delivered. If the supplier can't fill it, the order becomes refunded and the money goes back to your wallet automatically.

Get an order

GET/api/v1/orders/{id}

Fetch one order again, including its logins. {id} can be the GhostLogs order id or your own reference.

curl https://www.ghostlogs.org/api/v1/orders/MYSHOP-1042 \
  -H "Authorization: Bearer $GHOSTLOGS_API_KEY"

List orders

GET/api/v1/orders?limit=20

Your most recent API orders (newest first, up to 100). Use Get an order to see the logins of one.

Response
{
  "success": true,
  "data": {
    "count": 1,
    "orders": [
      {
        "id": "c1d2e3f4-5a6b-7c8d-9e0f-112233445566",
        "status": "delivered",
        "total": 2160,
        "currency": "NGN",
        "created_at": "2026-11-17T09:12:44Z",
        "delivered_at": "2026-11-17T09:12:44Z"
      }
    ]
  }
}

Errors

When something goes wrong, success is false and error.code tells you why. If an order fails, you are never charged.

Error response ยท 402
{
  "success": false,
  "error": {
    "code": "insufficient_balance",
    "message": "Insufficient wallet balance. You need โ‚ฆ4,320 but your balance is โ‚ฆ2,600.",
    "balance": 2600,
    "required": 4320,
    "shortfall": 1720
  }
}
HTTPcodeMeaning
400invalid_body ยท invalid_product_id ยท invalid_quantity ยท invalid_reference ยท invalid_idFix the request and try again.
401missing_key ยท invalid_keyKey missing, mistyped or reset.
402insufficient_balanceFund your wallet, then retry with the same reference.
403key_pending ยท key_revoked ยท key_rejectedAccess not approved or switched off.
404product_not_found ยท order_not_foundWrong id, or the product is no longer for sale.
409out_of_stock ยท reference_in_use ยท supplier_failedNot enough stock, reference still processing, or the supplier failed (you were refunded).
429rate_limitedToo many requests. Wait for the Retry-After seconds.
503api_disabledAPI is under maintenance. Try again later.

Good practice

  • Always send a reference (your own order number). If your connection drops, retry with the same reference: you get the same order back and are never charged twice.
  • Check stock before selling. Call List products every few minutes and hide items with stock: 0 on your website. Keep items with stock: null (stock not reported).
  • Keep your wallet funded. Watch the balance_after value in each order reply and top up before it runs out.
  • Respect the rate limit. Cache the product list instead of calling it for every visitor.
  • Save the logins on your side when an order succeeds, and also keep the GhostLogs order id for support.
Questions about the API? Telegram ยท WhatsApp ยท ghostlogssupport@gmail.com