Get Started ⚡
v1.0 REST API

Developer API Documentation

Automate orders for digital accounts, temporary OTP phone numbers, and SMM growth packages with our high-throughput JSON API.

⚡
Scheduled Release REST API v1.0 Preview

Developer & Reseller API Preview

The endpoints and schemas below represent the upcoming ICE Socials REST API specification. External endpoint connectivity and merchant API token generation are currently undergoing scheduled deployment hardening and will open to all verified accounts shortly.

1. Overview & Base URL

The ICE Socials API is organized around REST standards. Requests must be made over HTTPS with a JSON payload and response format.

API Base URL:
https://icetechapp.com/api/v1/

2. Authentication

Authenticate all API requests by providing your secure API key via the X-API-Key request header or as a key POST parameter.

curl -X POST "https://icetechapp.com/api/v1/user/balance" \ -H "X-API-Key: YOUR_API_SECRET_KEY" \ -H "Content-Type: application/json"
GET POST /user/balance

Retrieve current available Nigerian Naira (₦) wallet balance and account status.

Sample Response (200 OK):
{ "status": "success", "data": { "balance": 18420.50, "currency": "NGN", "user_id": 42, "username": "reseller_pro" } }
GET /digital/products

List all active digital accounts, gift cards, and software license stock with available quantities and prices.

Sample Response (200 OK):
{ "status": "success", "products": [ { "id": 12, "category": "Twitter / X", "name": "Twitter / X Verified Account (2FA + Email Included)", "price": 1468.80, "currency": "NGN", "stock": 45, "delivery_mode": "instant" } ] }
POST /numbers/order

Request an instant temporary phone number for SMS verification.

Request Parameters:
ParameterTypeRequiredDescription
country_idIntegerYesTarget Country ID (e.g. 1 for USA)
service_codeStringYesService identifier (e.g. tg, wa, go)
Sample Response (200 OK):
{ "status": "success", "order_id": 90812, "phone_number": "+14155550199", "cost": 650.00, "expires_in_seconds": 900 }
POST /smm/order

Place an automated social media marketing order.

{ "service_id": 105, "link": "https://instagram.com/your_profile", "quantity": 1000 }

3. Rate Limits & HTTP Error Codes

Standard rate limits are 120 requests per minute per API key. When throttled, an HTTP 429 status code is returned.

HTTP CodeError TypeDescription
400Bad RequestMissing or invalid request payload parameters.
401UnauthorizedMissing or invalid X-API-Key credential.
402Insufficient FundsWallet balance is too low for the requested order.
429Rate Limit ExceededRequest frequency exceeded 120 req/min threshold.
500Server ErrorUpstream node temporary timeout. Safe to retry.