Introduction

Welcome to the Code Flash New API. This API allows you to programmatically access all our services (SMM, OTP/SMS, and ACCOUNT SERVICES).

Base URL

https://socialsite.store/api/v1

Authentication

All API requests require authentication using your API key. You can find your API key in your profile settings.

Include your API key in every request as a query parameter:

Query Parameter Authentication

URL Parameter 
https://socialsite.store/api/v1/balance?key=your_api_key_here

Example Request

cURL 
curl "https://socialsite.store/api/v1/balance?key=your_api_key_here"

Security Warning

Never share your API key or expose it in client-side code. Keep it secure and regenerate it immediately if compromised.

Rate Limits

API requests are rate limited to ensure fair usage. Rate limits are applied per endpoint type:

Endpoint Type Limit Window
Balance Check60 requests1 minute
List Services/Products30 requests1 minute
Place Orders10 requests1 minute
Status Checks30 requests1 minute

Rate limit headers are included in every response:

  • X-RateLimit-Limit - Maximum requests allowed
  • X-RateLimit-Remaining - Requests remaining

Error Handling

The API uses standard HTTP status codes and returns consistent error responses:

Status CodeDescription
200Success
400Bad Request - Invalid parameters
401Unauthorized - Invalid API key
404Not Found - Resource not found
429Too Many Requests - Rate limit exceeded
500Server Error - Something went wrong
405Method Not Allowed - Invalid HTTP method
422Validation Failed - Invalid parameters

Error Response Format

JSON
{
    "success": false,
    "error": "Error message describing what went wrong"
}

Get Balance

Retrieve your current account balance.

GET /balance

Response

JSON
{
    "success": true,
    "data": {
        "balance": "15000.00",
        "currency": "NGN"
    }
}

SMM - List Services

Get a list of all available SMM services with pricing.

GET /smm/services

Response

JSON
{
    "success": true,
    "data": [
        {
            "service_id": 1,
            "name": "Instagram Followers",
            "category": "Instagram",
            "type": "Default",
            "rate": "500.00",
            "min": 100,
            "max": 10000,
            "description": "High quality followers"
        }
    ]
}

SMM - Place Order

Place a new SMM service order.

POST /smm/order

Parameters

ParameterTypeDescription
service requiredintegerService ID from services list
link requiredstringTarget URL for the service
quantity requiredintegerQuantity (must be within min/max)

Example Request

cURL
curl -X POST "https://socialsite.store/api/v1/smm/order?key=your_api_key" \
    -H "Content-Type: application/json" \
    -d '{
        "service": 1,
        "link": "https://instagram.com/username",
        "quantity": 1000
    }'

Response

JSON
{
    "success": true,
    "message": "Order placed successfully",
    "data": {
        "order_id": 12345,
        "service": "Instagram Followers",
        "link": "https://instagram.com/username",
        "quantity": 1000,
        "charge": "500.00",
        "status": "pending",
        "balance": "14500.00",
        "currency": "NGN"
    }
}

SMM - Order Status

Check the status of an SMM order.

GET /smm/status?order={order_id}

Parameters

ParameterTypeDescription
order requiredintegerOrder ID

Response

JSON
{
    "success": true,
    "data": {
        "order_id": 12345,
        "service": "Instagram Followers",
        "link": "https://instagram.com/username",
        "quantity": 1000,
        "charge": "500.00",
        "status": "completed",
        "start_count": 1500,
        "remains": 0,
        "created_at": "2026-01-29T10:30:00+00:00"
    }
}

SMM - Order History

Get list of your SMM orders.

GET /smm/orders?page=1&limit=20

Parameters

ParameterTypeDescription
pageintegerPage number (default: 1)
limitintegerResults per page (max: 100, default: 20)

Response

JSON
{
    "success": true,
    "data": {
        "orders": [
            {
                "order_id": 123,
                "service": "Instagram Followers",
                "link": "https://instagram.com/username",
                "quantity": 1000,
                "charge": "500.00",
                "status": "completed",
                "start_count": 1000,
                "remains": 0,
                "created_at": "2024-01-15T10:30:00Z"
            }
        ],
        "pagination": {
            "current_page": 1,
            "per_page": 20,
            "total": 50,
            "total_pages": 3
        }
    }
}

OTP - List Countries

Get list of available countries for OTP services.

GET /otp/countries

Response

JSON
{
    "success": true,
    "data": [
        {"id": 1, "name": "United States", "code": "US"},
        {"id": 2, "name": "United Kingdom", "code": "GB"}
    ]
}

OTP - List Services

Get available OTP services for a specific country.

GET /otp/services?country={country_id}

Parameters

ParameterTypeDescription
country requiredintegerCountry ID

Response

JSON
{
    "success": true,
    "data": [
        {
            "service_id": 1,
            "name": "WhatsApp",
            "code": "wa",
            "price": "350.00",
            "available": 150
        }
    ]
}

OTP - Purchase Number

Purchase a phone number for OTP verification.

POST /otp/purchase

Parameters

ParameterTypeDescription
country requiredintegerCountry ID
service requiredintegerService ID

Response

JSON
{
    "success": true,
    "message": "Number purchased successfully",
    "data": {
        "order_id": 789,
        "phone_number": "+1234567890",
        "request_id": "abc123",
        "service": "WhatsApp",
        "country": "United States",
        "charge": "350.00",
        "status": "active",
        "balance": "14650.00",
        "currency": "NGN"
    }
}

OTP - Check SMS

Check if SMS code has been received.

GET /otp/check?request_id={request_id}

Parameters

ParameterTypeDescription
request_id requiredstringRequest ID from purchase

Response

JSON
{
    "success": true,
    "data": {
        "order_id": 789,
        "phone_number": "+1234567890",
        "status": "completed",
        "sms_code": "123456"
    }
}

Status Values

StatusDescription
waitingSMS has not been received yet. Keep polling this endpoint until status changes.
completedSMS received successfully. The sms_code field will contain the verification code.
expiredThe request has expired without receiving an SMS. Your balance has been automatically refunded.
cancelledThe order was cancelled by the user. Balance has been refunded.

OTP - Cancel Order

Cancel an active OTP order.

POST /otp/cancel

Parameters

ParameterTypeDescription
request_id requiredstringRequest ID from purchase

Response

JSON
{
    "success": true,
    "message": "Order cancelled and refunded successfully",
    "data": {
        "order_id": 789,
        "refund_amount": "350.00",
        "balance": "15000.00"
    }
}

OTP - Order History

Get list of your OTP orders.

GET /otp/orders?page=1&limit=20

Parameters

ParameterTypeDescription
pageintegerPage number (default: 1)
limitintegerResults per page (max: 100, default: 20)

Response

JSON
{
    "success": true,
    "data": {
        "orders": [
            {
                "order_id": 789,
                "request_id": "44784888383838",
                "phone_number": "+1234567890",
                "service": "WhatsApp",
                "country": "United States",
                "charge": "350.00",
                "status": "completed",
                "sms_code": "123456",
                "created_at": "2024-01-15T10:30:00Z"
            }
        ],
        "pagination": {
            "current_page": 1,
            "per_page": 20,
            "total": 25,
            "total_pages": 2
        }
    }
}

Accounts - List Categories

Get list of account product categories.

GET /accounts/categories

Response

JSON
{
    "success": true,
    "data": [
        {"id": 1, "name": "Social Media", "icon": "users"},
        {"id": 2, "name": "Streaming", "icon": "play"}
    ]
}

Accounts - List Products

Get available account products for a category.

GET /accounts/products?category={category_id}

Parameters

ParameterTypeDescription
category requiredintegerCategory ID

Response

JSON
{
    "success": true,
    "data": [
        {
            "product_id": 1,
            "name": "Netflix Premium Account",
            "price": "2500.00",
            "stock": 50,
            "min": 1,
            "max": 10,
            "description": "Premium Netflix account"
        }
    ]
}

Accounts - Purchase

Purchase social media account(s).

POST /accounts/purchase

Parameters

ParameterTypeDescription
product requiredintegerProduct ID
quantity requiredintegerQuantity (within min/max)

Response

JSON
{
    "success": true,
    "message": "Account(s) purchased successfully",
    "data": {
        "order_id": 456,
        "product": "Netflix Premium Account",
        "quantity": 1,
        "charge": "2500.00",
        "status": "completed",
        "accounts": [
            {"email": "user@example.com", "password": "pass123"}
        ],
        "balance": "12500.00",
        "currency": "NGN"
    }
}

Accounts - Order History

Get list of your account orders.

GET /accounts/orders?page=1&limit=20

Parameters

ParameterTypeDescription
pageintegerPage number (default: 1)
limitintegerResults per page (max: 100, default: 20)

Response

JSON
{
    "success": true,
    "data": {
        "orders": [
            {
                "order_id": 10,
                "product": "Netflix Premium Account",
                "quantity": 1,
                "charge": "572.40",
                "status": "completed",
                "accounts": [
                    "Username:Password"
                ],
                "created_at": "2026-01-29T22:45:43+00:00"
            }
        ],
        "pagination": {
            "current_page": 1,
            "per_page": 20,
            "total": 15,
            "total_pages": 1
        }
    }
}

Accounts - Order Details

Get details of a specific account order.

GET /accounts/order?order={order_id}

Parameters

ParameterTypeDescription
order requiredintegerOrder ID

Response

JSON
{
    "success": true,
    "data": {
        "order_id": 10,
        "product": "Netflix Premium Account",
        "quantity": 1,
        "price_per_unit": "572.40",
        "charge": "572.40",
        "status": "completed",
        "accounts": [
            "Username:Password",
            "Username:Password"
        ],
        "created_at": "2026-01-29T22:45:43+00:00"
    }
}

Need Help?

If you have any questions or issues with the API, please contact our support team.