API Reference v1
Complete documentation for N1SMS public API
Base URL: /api/mobile
RESTful API
JSON Response
Complete documentation for N1SMS public API
Use these IDs when making API requests
One-Time SMS
1688
1012
329
457
Telegram
907
TikTok
924
Twitter/X
948
YouTube
1227
395
Authentication Required: All authenticated endpoints require a Bearer token in Authorization header
Register a new user account.
{
"name": "John Doe",
"email": "john@example.com",
"phone": "+233XXXXXXXXX",
"password": "password123",
"password_confirmation": "password123",
"referral_code": "OPTIONAL_CODE"
}{
"success": true,
"message": "Registration successful. Please verify your phone number.",
"data": {
"user_id": 1,
"requires_verification": true
}
}Authenticate user and get access token.
{
"email": "john@example.com",
"password": "password123"
}{
"success": true,
"message": "Login successful",
"data": {
"token": "1|abc123...",
"token_type": "Bearer",
"expires_at": "2026-02-14T00:00:00.000000Z",
"user": {
"id": 1,
"name": "John Doe",
"email": "john@example.com",
"phone": "+233XXXXXXXXX"
}
}
}Include your token in Authorization header for authenticated requests:
Authorization: Bearer YOUR_TOKEN_HEREGet user dashboard statistics and recent activity
Get country prices for a specific service
Query: ?service=1688&page=1
Get list of available services
Get list of user's orders
Query: ?status=active&page=1&per_page=20
Create a new SMS number order
{
"country": "1",
"service": "1688",
"pool": "optional_pool",
"pricing_option": "0"
}Use these IDs when making API requests
One-Time SMS
1688
1012
329
457
Telegram
907
TikTok
924
Twitter/X
948
YouTube
1227
395
Download complete API documentation file for offline reference
Download Full Documentation