Vibez Tools API

Check your balance, browse Grow Socials and SMS services, and place orders paid from your wallet.

Authentication

Create a key under Profile → Developer & API Keys. Send it on every request using either header:

Authorization: Bearer vbz_live_xxxxxxxx

x-api-key: vbz_live_xxxxxxxx

Base URL: https://vibez-space.lovable.app/api/v1
Test keys (vbz_test_) can read data only. Live keys (vbz_live_) can also place real orders.
Limit: 60 requests per minute per key. All prices are in Naira (NGN).
Keep keys secret — use them only from your server, never in a public website or app.
Every response is { success, data } or { success: false, error: { code, message } }.

Endpoints

GET/api/v1/user/balance

Get wallet balance

Returns your current wallet balance.

curl "https://vibez-space.lovable.app/api/v1/user/balance" \
  -H "Authorization: Bearer $VIBEZ_API_KEY"

Response

{ "success": true, "data": { "balance": 15000, "currency": "NGN" } }

GET/api/v1/services/socials

List Grow Socials services

Active services with live prices per 1,000 units.

Query	Type	Description
limit	number	1–500, default 100
offset	number	Pagination offset, default 0
platform	string	Filter, e.g. Instagram
search	string	Match words in the service name

curl "https://vibez-space.lovable.app/api/v1/services/socials?limit=50" \
  -H "Authorization: Bearer $VIBEZ_API_KEY"

Response

{ "success": true, "data": { "total": 1240, "limit": 50, "offset": 0, "currency": "NGN",
  "services": [{ "service_id": 1234, "name": "Instagram Followers", "platform": "Instagram",
    "category": "Followers", "min_quantity": 100, "max_quantity": 50000, "refill": true, "price_per_1000": 2450 }] } }

GET/api/v1/services/sms

List SMS countries & services

Without country: every available country. With country: every service and price for it.

Query	Type	Description
country	string	Optional country code from the countries list, e.g. usa

curl "https://vibez-space.lovable.app/api/v1/services/sms?country=usa" \
  -H "Authorization: Bearer $VIBEZ_API_KEY"

Response

{ "success": true, "data": { "country": "usa", "currency": "NGN",
  "services": [{ "service_id": "usa:whatsapp", "service": "whatsapp", "country": "USA", "price": 1200, "stock": 340 }] } }

POST/api/v1/orders/create

Create an order

Charges your wallet and starts the order. Live keys only. Use type "socials" or "sms".

JSON body

// Grow Socials
{ "type": "socials", "service_id": 1234, "link": "https://instagram.com/yourpage", "quantity": 1000 }

// SMS number (pool optional: "titan", "nova", "quasar", "orbit", "vega", "atlas", "nexus"…; cheapest pool when omitted)
{ "type": "sms", "service_id": "usa:whatsapp", "pool": "titan" }

curl -X POST "https://vibez-space.lovable.app/api/v1/orders/create" \
  -H "Authorization: Bearer $VIBEZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"socials","service_id":1234,"link":"https://instagram.com/yourpage","quantity":1000}'

Response

{ "success": true, "data": { "order_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "type": "socials", "status": "Pending", "cost": 2450, "currency": "NGN", "created_at": "2026-10-15T22:00:00Z" } }

GET/api/v1/orders/:id

Get an order

Order status, delivery details and timestamps. For SMS orders, the received code appears in details.code.

curl "https://vibez-space.lovable.app/api/v1/orders/ORDER_ID" \
  -H "Authorization: Bearer $VIBEZ_API_KEY"

Response

{ "success": true, "data": { "order_id": "7c9e…", "type": "sms", "status": "Received", "cost": 1200, "currency": "NGN",
  "details": { "country": "USA", "service": "whatsapp", "phone": "+15551234567", "code": "482913", "refunded": false },
  "created_at": "…", "updated_at": "…" } }

Error codes

Status	Code	Meaning
400	bad_request / order_failed	Missing or invalid fields, or the order couldn't be placed (you're refunded).
401	unauthorized	API key missing, wrong or revoked.
402	insufficient_balance	Wallet balance too low — top up and retry.
403	forbidden / test_key	Key lacks the needed permission, or a test key tried to order.
404	not_found	Service or order doesn't exist (or isn't yours).
429	rate_limited / blocked	More than 60 requests a minute, or a temporary spending limit.
500	server_error	Something went wrong on our side. Retry later.