INSTALOGS API

A RESTful API to access all marketplace features programmatically — browse accounts, place boost orders, receive OTP codes, and manage your wallet.

🔑 Authentication required. All endpoints require an API key. Get yours from your Developer Dashboard.

lock Authentication

Include your API key in every request using one of these methods:

                
# Recommended: custom header
curl https://instalogs.net/api/v1/me \
  -H "X-API-Key: ik_live_YOUR_KEY"

# Bearer token
curl https://instalogs.net/api/v1/me \
  -H "Authorization: Bearer ik_live_YOUR_KEY"

# Query parameter (less secure)
curl "https://instalogs.net/api/v1/me?api_key=ik_live_YOUR_KEY"

⚠️ Keep your API keys secret. Never expose them in frontend JavaScript or public repositories.

Key Types

ik_live_*	Production key — real transactions, real balance deducted.
ik_test_*	Sandbox key — fully simulated, no balance deducted. Use on `/api/v1/sandbox/*` routes.

data_object Response Format

All responses return application/json with a top-level status field.

// ✅ Success
{
  "status": "success",
  "data": { ... },
  "meta": {
    "current_page": 1, "last_page": 5,
    "per_page": 20,  "total": 98
  }
}

// ❌ Error
{
  "status": "error",
  "message": "Insufficient wallet balance.",
  "errors": { "quantity": ["The quantity field is required."] }
}

error HTTP Status Codes

200	OK — Successful GET/listing
201	Created — Order or purchase was created
401	Unauthorized — Missing or invalid API key
403	Forbidden — Sandbox key on live route, or vice versa
404	Not Found — Resource doesn't exist or doesn't belong to you
410	Gone — SMS order expired or was refunded
422	Unprocessable — Validation error or business rule (e.g. insufficient balance)
500	Server Error — Contact support if persistent
502	Bad Gateway — Upstream provider error

shopping_bag Accounts

Browse and purchase social media accounts from the marketplace.

GET/api/v1/accountsList active accounts (paginated)

GET/api/v1/accounts/categoriesList categories

GET/api/v1/accounts/{id}Get a single account

POST/api/v1/accounts/{id}/purchasePurchase an account

Purchase Example

                
curl -X POST https://instalogs.net/api/v1/accounts/42/purchase \
  -H "X-API-Key: ik_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"quantity": 1}'

// Response (201)
{
  "status": "success",
  "message": "Account purchased successfully.",
  "data": {
    "id": 91, "type": "account", "total": 4500,
    "status": "completed",
    "items": [{ "credentials_delivered": { ... } }]
  }
}

rocket_launch Boost Services

Place social media growth orders — followers, likes, views, comments

GET/api/v1/boosts/categoriesList service categories

GET/api/v1/boosts/servicesList services with NGN prices

POST/api/v1/boosts/ordersPlace a boost order

GET/api/v1/boosts/ordersList your boost orders

GET/api/v1/boosts/orders/{id}Get order status (refreshed from provider)

Place Boost Order

                
curl -X POST https://instalogs.net/api/v1/boosts/orders \
  -H "X-API-Key: ik_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service_id": 123, "link": "https://instagram.com/yourhandle", "quantity": 500}'

// Response (201)
{
  "status": "success",
  "data": {
    "order_id": 7, "external_order_id": 98201,
    "service_name": "Instagram Followers",
    "quantity": 500, "total": 1350,
    "status": "processing"
  }
}

sms SMS Verification

Get a virtual phone number and receive OTP codes for any service — WhatsApp, Telegram, Google, and more.

GET/api/v1/sms/countriesAvailable countries

GET/api/v1/sms/servicesAvailable apps/services

GET/api/v1/sms/price?country=&service=Get NGN price

POST/api/v1/sms/ordersPurchase a number

GET/api/v1/sms/orders/{id}/checkPoll for OTP code

POST/api/v1/sms/orders/{id}/resendResend SMS

DELETE/api/v1/sms/orders/{id}Cancel order

Complete SMS Flow

                
# Step 1: Purchase a number
curl -X POST https://instalogs.net/api/v1/sms/orders \
  -H "X-API-Key: ik_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "United States", "service": "WhatsApp"}'

# Response → order_id: 5, number: "+15551234567"

# Step 2: Poll for OTP (repeat until status != "pending")
curl https://instalogs.net/api/v1/sms/orders/5/check \
  -H "X-API-Key: ik_live_YOUR_KEY"

// When OTP arrives (status: "completed"):
{
  "status": "success",
  "message": "OTP received.",
  "data": { "otp_code": "485920", "full_sms": "Your WhatsApp code is 485920" }
}

receipt_long Orders

View all your orders across all service types in one place.

GET/api/v1/ordersList all orders (filter by type, status)

GET/api/v1/orders/{id}Get a single order

POST/api/v1/ordersPlace account order directly

account_balance_wallet Wallet

GET/api/v1/wallet/balanceCurrent NGN balance

GET/api/v1/walletBalance + transaction history

GET/api/v1/meYour profile + wallet + key metadata

science Sandbox

Test your integration safely using your ik_test_* key on /api/v1/sandbox/* routes. No real transactions are made.

🔬 Sandbox routes require a sandbox key (ik_test_*). Using a live key returns 403.

                
# Test SMS purchase (no real cost)
curl -X POST https://instalogs.net/api/v1/sandbox/sms/orders \
  -H "X-API-Key: ik_test_YOUR_SANDBOX_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "United States", "service": "WhatsApp"}'

// Returns mock data instead of real number
{ "sandbox": true, "number": "+15557859130", "otp_code": null }

Ready to integrate?

Get your API keys from your developer dashboard and start building.

person_add Create an Account