API Documentation | Socialvex

Authentication

Pass your personal API key on every request. Find or regenerate it in the developer API area after logging in.

api_key=YOUR_API_KEY

Number API

Virtual numbers and OTP — base path http://sms.nairahint.com/api/v1. Responses are plain text unless noted.

Flow: servers → countries → services (with prices) → get-number

GET /api/v1/balance

Returns wallet balance as plain text.

http://sms.nairahint.com/api/v1/balance?api_key=YOUR_API_KEY

Response: ACCESS_BALANCE:25.40

GET /api/v1/servers

List active number servers (JSON).

http://sms.nairahint.com/api/v1/servers?api_key=YOUR_API_KEY

{ "status": "success", "servers": [{ "id": 1, "name": "Server A" }] }

GET /api/v1/countries

Countries for a server (JSON). Requires server_id from servers list.

http://sms.nairahint.com/api/v1/countries?api_key=YOUR_API_KEY&server_id=1

{ "status": "success", "countries": [{ "id": 5, "name": "United States", "code": "US", "country_id": "12" }] }

GET /api/v1/services

Services with prices for a server + country (JSON). Use code when ordering.

http://sms.nairahint.com/api/v1/services?api_key=YOUR_API_KEY&server_id=1&country=5

{ "status": "success", "services": [
  { "id": 10, "code": "wa", "name": "WhatsApp", "price": "1.50" }
] }

GET /api/v1/get-number

Buy a virtual number. Deducts wallet balance at the listed price.

http://sms.nairahint.com/api/v1/get-number?api_key=YOUR_API_KEY&country=COUNTRY_ID&service=SERVICE_CODE

Response: ACCESS_NUMBER:ORDER_ID:+1234567890

GET /api/v1/status

Poll SMS/OTP for an order.

http://sms.nairahint.com/api/v1/status?api_key=YOUR_API_KEY&id=ORDER_ID

Responses: STATUS_WAIT_CODE | STATUS_OK:123456 | STATUS_CANCEL

GET /api/v1/set-status

Cancel (8) or request retry (3) while waiting for SMS.

http://sms.nairahint.com/api/v1/set-status?api_key=YOUR_API_KEY&id=ORDER_ID&status=8

Plain-text errors: BAD_KEY, BAD_API, BAD_COUNTRY, BAD_SERVICE, NO_BALANCE.

SMM API

Social boosting — base path http://sms.nairahint.com/api/v1/smm. JSON request/response.

Flow: servers → categories → services (with rates) → order

GET/POST /api/v1/smm/balance

Returns wallet balance (JSON).

http://sms.nairahint.com/api/v1/smm/balance?api_key=YOUR_API_KEY

{ "status": "success", "balance": 25.40, "currency": "₦" }

GET/POST /api/v1/smm/servers

List active SMM servers (JSON).

http://sms.nairahint.com/api/v1/smm/servers?api_key=YOUR_API_KEY

{ "status": "success", "servers": [{ "id": 1, "name": "Server A" }] }

GET/POST /api/v1/smm/categories

Categories for a server. Requires server_id from servers list.

http://sms.nairahint.com/api/v1/smm/categories?api_key=YOUR_API_KEY&server_id=1

{ "status": "success", "categories": [{ "id": 2, "name": "Instagram", "server_id": 1 }] }

GET/POST /api/v1/smm/services

Services with prices for a server + category. rate is price per 1000 units.

http://sms.nairahint.com/api/v1/smm/services?api_key=YOUR_API_KEY&server_id=1&category_id=2

{ "status": "success", "services": [
  { "id": 12, "name": "Followers", "rate": "2.5000", "min": 100, "max": 10000, "refill": false }
] }

GET/POST /api/v1/smm/order

Place an order. Uses internal service_id from the services list.

http://sms.nairahint.com/api/v1/smm/order?api_key=YOUR_API_KEY&service_id=12&link=https://example.com/post&quantity=1000

{ "status": "success", "order": { "id": 1, "price": "5.00", "status": "processing" } }

GET/POST /api/v1/smm/status

Check order status by internal order id.

http://sms.nairahint.com/api/v1/smm/status?api_key=YOUR_API_KEY&order_id=1

GET/POST /api/v1/smm/cancel

Cancel a pending/processing order and refund wallet.

http://sms.nairahint.com/api/v1/smm/cancel?api_key=YOUR_API_KEY&order_id=1

JSON errors: { "status": "error", "message": "..." }

Need Help?

Having trouble integrating? Reach out via our contact page and our team will assist you.