Getting started
- Request access. Go to My account โ Reseller API and tell us about your website. We approve requests manually.
- Create your key. Once approved, create a key on the same page. It is shown once, so store it safely.
- Fund your wallet. Every API order is paid from your GhostLogs wallet balance. Approved resellers may get a discount on every product.
- 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.
Authorization: Bearer gl_live_xxxxxxxxxxxxxxxxxxxxxxxx
Check balance
/api/v1/balanceYour current GhostLogs wallet balance in naira.
curl https://www.ghostlogs.org/api/v1/balance \ -H "Authorization: Bearer $GHOSTLOGS_API_KEY"
{
"success": true,
"data": { "balance": 25000, "currency": "NGN" }
}List products
/api/v1/productsEverything 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"
{
"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
/api/v1/ordersBuys the product with your wallet and returns the logins immediately. Send a JSON body:
| Field | Type | Description |
|---|---|---|
product_id | string, required | The id from List products. |
quantity | number, 1โ100 | How many to buy. Default 1. |
reference | string, optional | Your 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"}'{
"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"
]
}
}credentials is one complete login as plain text (it may contain line breaks). Show it to your customer exactly as received.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
/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
/api/v1/orders?limit=20Your most recent API orders (newest first, up to 100). Use Get an order to see the logins of one.
{
"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.
{
"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
}
}| HTTP | code | Meaning |
|---|---|---|
| 400 | invalid_body ยท invalid_product_id ยท invalid_quantity ยท invalid_reference ยท invalid_id | Fix the request and try again. |
| 401 | missing_key ยท invalid_key | Key missing, mistyped or reset. |
| 402 | insufficient_balance | Fund your wallet, then retry with the same reference. |
| 403 | key_pending ยท key_revoked ยท key_rejected | Access not approved or switched off. |
| 404 | product_not_found ยท order_not_found | Wrong id, or the product is no longer for sale. |
| 409 | out_of_stock ยท reference_in_use ยท supplier_failed | Not enough stock, reference still processing, or the supplier failed (you were refunded). |
| 429 | rate_limited | Too many requests. Wait for the Retry-After seconds. |
| 503 | api_disabled | API 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: 0on your website. Keep items withstock: null(stock not reported). - Keep your wallet funded. Watch the
balance_aftervalue 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.