Dokumentasi API NomorID

Selamat datang di dokumentasi resmi REST API NomorID. Integrasikan layanan penerimaan SMS OTP virtual number ke dalam bot Telegram, script bot automasi, backend aplikasi, atau sistem reseller Anda dengan latensi rendah dan auto-refund otomatis.

Fitur Unggulan API NomorID:
  • Format respon standar JSON terstruktur.
  • Dukungan header x-api-key langsung tanpa perlu login ulang token.
  • Fitur Resend OTP untuk verifikasi berulang.
  • Auto-refund saldo instan jika nomor kedaluwarsa atau dibatalkan.

Autentikasi & Header

Semua endpoint yang memerlukan hak akses pengguna dapat diakses menggunakan header x-api-key dengan kunci rahasia Anda, atau menggunakan Authorization: Bearer <token>.

Header Permintaan 
x-api-key: nid-your_api_key_here
Content-Type: application/json
Accept: application/json

Base URL

https://your-domain.com/api
GET /api/nokos/countries

Mengambil seluruh daftar negara yang didukung oleh NomorID. Rekomendasi negara Indonesia memiliki id: 6. 

curl -X GET "https://your-domain.com/api/nokos/countries"

Contoh Response Success (200 OK):

{
  "success": true,
  "data": [
    {
      "id": 6,
      "name": "Indonesia",
      "visible": 1,
      "retry": 1
    },
    {
      "id": 74,
      "name": "Afghanistan",
      "visible": 1,
      "retry": 1
    }
  ]
}
GET /api/nokos/services

Mengambil daftar layanan atau aplikasi yang tersedia berdasarkan ID negara.

Parameter Query Tipe Wajib Deskripsi
country Integer Ya ID negara (Contoh: 6 untuk Indonesia)
Request cURL 
curl -X GET "https://your-domain.com/api/nokos/services?country=6"
GET /api/nokos/servers

Memeriksa harga, stok nomor yang tersedia, dan tingkat persentase keberhasilan OTP tiap server.

Parameter Query Tipe Wajib Deskripsi
service String Ya Kode layanan (Contoh: wa untuk WhatsApp)
country Integer Ya ID negara (Contoh: 6)
Contoh Response: 
{
  "status": true,
  "layanan": "Whatsapp",
  "negara": "Indonesia",
  "server": [
    {
      "id": 91,
      "label": "Server 1",
      "harga": 2249,
      "stok": 5753,
      "tingkat_otp": 15.62
    },
    {
      "id": 726,
      "label": "Server 24",
      "harga": 10648,
      "stok": 1000,
      "tingkat_otp": 3.13
    }
  ]
}
POST /api/nokos/order

Membeli nomor virtual baru secara instan. Saldo akun akan terpotong secara otomatis.

cURL Request 
curl -X POST "https://your-domain.com/api/nokos/order" \
  -H "x-api-key: nid-your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "service": "wa",
    "country": 6,
    "provider_id": 91,
    "expected_price": 2249
  }'
Response Berhasil (200 OK): 
{
  "success": true,
  "message": "Nomor virtual berhasil dibeli!",
  "data": {
    "orderId": "RUANGOTP1698769999999",
    "activationId": "987654321",
    "service": "wa",
    "country": "6",
    "countryName": "Indonesia",
    "phoneNumber": "6281234567890",
    "status": "WAIT_CODE",
    "price": 2249,
    "activationEndTime": "2026-10-07T07:20:00.000Z"
  },
  "balance": 47751
}
GET /api/nokos/status

Mengecek status nomor dan mengambil kode OTP / isi SMS yang masuk.

Request cURL 
curl -X GET "https://your-domain.com/api/nokos/status?order_id=RUANGOTP1698769999999" \
  -H "x-api-key: nid-your_api_key_here"
Response OTP Masuk (COMPLETED): 
{
  "success": true,
  "data": {
    "order_id": "RUANGOTP1698769999999",
    "status": "COMPLETED",
    "otp_code": "123456",
    "sms": "Kode verifikasi WhatsApp Anda adalah 123456."
  }
}
POST /api/nokos/resend

Meminta kirim ulang SMS OTP kedua jika kode pertama salah atau kedaluwarsa. 

curl -X POST "https://your-domain.com/api/nokos/resend" \
  -H "x-api-key: nid-your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"order_id": "RUANGOTP1698769999999"}'
POST /api/nokos/cancel

Membatalkan pesanan nomor virtual. Saldo akan otomatis dikembalikan (refund) secara instan ke akun NomorID Anda. 

curl -X POST "https://your-domain.com/api/nokos/cancel" \
  -H "x-api-key: nid-your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"order_id": "RUANGOTP1698769999999"}'
GET /api/user/profile

Mengambil informasi akun dan sisa saldo aktif. 

curl -X GET "https://your-domain.com/api/user/profile" \
  -H "x-api-key: nid-your_api_key_here"