Tpin Support

Online 24/7

HOW CAN WE HELP?
Number Issues Payment Help API Support General Inquiry
Chat on Telegram Join Telegram Channel Follow us on TikTok
Average response time: < 5 minutes
Sign In Sign Up
Sign In Sign Up
Developers

API Documentation

Integrate Tpin into your own apps. Resell virtual numbers and social boosting using your wallet balance.

Log in for your API key

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 https://tpin.ng/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.

https://tpin.ng/api/v1/balance?api_key=YOUR_API_KEY Response: ACCESS_BALANCE:25.40
GET /api/v1/servers

List active number servers (JSON).

https://tpin.ng/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.

https://tpin.ng/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.

https://tpin.ng/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.

https://tpin.ng/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.

https://tpin.ng/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.

https://tpin.ng/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 https://tpin.ng/api/v1/smm. JSON request/response.

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

GET/POST /api/v1/smm/balance

Returns wallet balance (JSON).

https://tpin.ng/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).

https://tpin.ng/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.

https://tpin.ng/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.

https://tpin.ng/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.

https://tpin.ng/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.

https://tpin.ng/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.

https://tpin.ng/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.