gethttps://onlinesim.io/api/getFreeList

GET /api/getFreeList

Get list of free numbers

Depending on the parameters returns information on available countries with free numbers, received messages and the list of restricted services.

Without parameters: returns a list of available countries with free numbers, messages received by the first number from the list and the list of restricted services.

With country parameter: returns a list of available free numbers of that country, messages received by the first number from the list and the list of restricted services.

With country and number parameters: returns a list of SMS messages received by this number and the list of restrices services.

You can send this request to get a number that can be used for SMS receiving, for example for testing.

Parameters

query3
NameTypeDescription
countryinteger
≥ 1

'International dialing code of the country (Е.164 standard, without "+" sign), see country list'

Default:7Example:46
numberstring

Free phone number, without country code

Example:9100100101
langstring

Response language: fr - French, de - German, ru - Russian, en - English, zh - Chinese. Please note that the translation applies only to string field values, such as service names or country names. Field names themselves, error messages, and standard values (for example, true/false for boolean fields) remain in English.

Enum:frderuenzhDefault:ruExample:en

Responses

200

Successful response for getFreeList request: the server returns information on free numbers and messages they've received.

Content-Typeapplication/json
Schema
Responseobject
responseanyOf

1, if the request has been completed successfully, or an error message

any of
[0]string
[1]number
countriesobject[]

Array of countries with their corresponding international phone codes

itemsobject
countryinteger

International dialing code of the country (Е.164 standard, without "+" sign), see country list

≥ 1
Default:7Example:46
country_textstring

Country name, to which mobile number belongs

Example:Sweden
numbersobject
#number#object

Phone number without a country code

countryinteger

International dialing code of the country (Е.164 standard, without "+" sign), see country list

≥ 1
Default:7Example:46
data_humansstring

How long ago the number was placed

Example:6 days ago
full_numberstring

Phone number in the international format with "+" sign

Example:+79915584911
is_archiveboolean

Was number placed in archive (unavailable for use at the time of request) - true/false

messagesobject

Free numbers messages

current_pageinteger

All messages are sorted in reverse chronological order and are grouped into pages, each containing 10 messages (first page contains the last 10 messages)

≥ 1
Example:1
dataobject[]
itemsobject
textstring

SMS context

in_numberstring

Phone number or name of a sender

my_numberinteger

Free number that has received the current SMS

created_atstring

Date and time when the message was received

data_humansstring

How long ago the number was placed

Example:6 days ago
first_page_urlstring

URL of the first page of this message list

frominteger

Number of the first message on this page

last_pageinteger

Number of last page with received SMS messages

last_page_urlstring

URL of the last page of this message list

linksobject[]

Array of URLs for navigation

itemsobject
urlstring

URLs for pagination

labelstring

Displayed name of the button (page number indication)

activeboolean

Is this button active (is user currently on this page of SMS messages)

next_page_urlstring

URL for the next page (opens the next page)

pathstring

API endpoint path

per_pageinteger

Amount of messages displayed on a single page

prev_page_urlstring

URL for the "Back" button (returns one page back)

tointeger

Number of the last message on the current page

totalinteger

Total amount of SMS received by this number

numberstring

Phone number without a country code

countryinteger

International dialing code of the country (Е.164 standard, without "+" sign), see country list

≥ 1
Default:7Example:46
ignorestring

List of restricted services (SMS from these services are unavailable)

Examples

Successful getFreeList response example (no parameters passed)264 lines
{
  "response": 1,
  "countries": [
    {
      "country": 7,
      "country_text": "Россия"
    },
    {
      "country": 380,
      "country_text": "Украина"
    },
    {
      "country": 77,
      "country_text": "Казахстан"
    },
    {
      "country": 44,
      "country_text": "Британия"
    },
    {
      "country": 371,
      "country_text": "Латвия"
    },
    {
      "country": 31,
      "country_text": "Нидерланды"
    },
    {
      "country": 34,
      "country_text": "Испания"
    },
    {
      "country": 372,
      "country_text": "Эстония"
    },
    {
      "country": 33,
      "country_text": "Франция"
    },
    {
      "country": 358,
      "country_text": "Финляндия"
    },
    {
      "country": 1,
      "country_text": "США"
    },
    {
      "country": 46,
      "country_text": "Швеция"
    },
    {
      "country": 39,
      "country_text": "Италия"
    },
    {
      "country": 351,
      "country_text": "Португалия"
    },
    {
      "country": 57,
      "country_text": "Колумбия"
    },
    {
      "country": 40,
      "country_text": "Румыния"
    },
    {
      "country": 212,
      "country_text": "Марокко"
    }
  ],
  "numbers": {
    "9099317316": {
      "country": 7,
      "data_humans": "6 дней назад",
      "full_number": "+79099317316",
      "is_archive": false
    },
    "9585027963": {
      "country": 7,
      "data_humans": "2 дня назад",
      "full_number": "+79585027963",
      "is_archive": false
    },
    "9915584205": {
      "country": 7,
      "data_humans": "2 дня назад",
      "full_number": "+79915584205",
      "is_archive": false
    },
    "9915584176": {
      "country": 7,
      "data_humans": "2 дня назад",
      "full_number": "+79915584176",
      "is_archive": false
    }
  },
  "messages": {
    "current_page": 1,
    "data": [
      {
        "text": "78123854000 received from onlinesim.io",
        "in_number": "***4000",
        "my_number": 9099317316,
        "created_at": "2022-07-27 16:44:21",
        "data_humans": "51 секунду назад"
      },
      {
        "text": "78123854000 received from onlinesim.io",
        "in_number": "***4000",
        "my_number": 9099317316,
        "created_at": "2022-07-27 16:43:47",
        "data_humans": "1 минуту назад"
      },
      {
        "text": "74957907277 received from onlinesim.io",
        "in_number": "***7277",
        "my_number": 9099317316,
        "created_at": "2022-07-27 16:36:44",
        "data_humans": "8 минут назад"
      },
      {
        "text": "74952235485 received from onlinesim.io",
        "in_number": "***5485",
        "my_number": 9099317316,
        "created_at": "2022-07-27 16:35:29",
        "data_humans": "9 минут назад"
      },
      {
        "text": "Ваш пароль 32166113 received from onlinesim.io",
        "in_number": "FCKRASNODAR",
        "my_number": 9099317316,
        "created_at": "2022-07-27 16:35:00",
        "data_humans": "10 минут назад"
      },
      {
        "text": "Введите 5407, чтобы подтвердить телефон в интернет-магазине е2е4 received from onlinesim.io",
        "in_number": "e2e4",
        "my_number": 9099317316,
        "created_at": "2022-07-27 16:31:13",
        "data_humans": "13 минут назад"
      },
      {
        "text": "79515984891 received from onlinesim.io",
        "in_number": "***4891",
        "my_number": 9099317316,
        "created_at": "2022-07-27 16:27:23",
        "data_humans": "17 минут назад"
      },
      {
        "text": "79622137000 received from onlinesim.io",
        "in_number": "***7000",
        "my_number": 9099317316,
        "created_at": "2022-07-27 16:24:37",
        "data_humans": "20 минут назад"
      },
      {
        "text": "79622137000 received from onlinesim.io",
        "in_number": "***7000",
        "my_number": 9099317316,
        "created_at": "2022-07-27 16:20:51",
        "data_humans": "24 минуты назад"
      },
      {
        "text": "79628078162 received from onlinesim.io",
        "in_number": "***8162",
        "my_number": 9099317316,
        "created_at": "2022-07-27 16:11:23",
        "data_humans": "33 минуты назад"
      }
    ],
    "first_page_url": "https://onlinesim.io/api/getFreeList?page=1",
    "from": 1,
    "last_page": 341,
    "last_page_url": "https://onlinesim.io/api/getFreeList?page=341",
    "links": [
      {
        "url": null,
        "label": "« Назад",
        "active": false
      },
      {
        "url": "https://onlinesim.io/api/getFreeList?page=1",
        "label": "1",
        "active": true
      },
      {
        "url": "https://onlinesim.io/api/getFreeList?page=2",
        "label": "2",
        "active": false
      },
      {
        "url": "https://onlinesim.io/api/getFreeList?page=3",
        "label": "3",
        "active": false
      },
      {
        "url": "https://onlinesim.io/api/getFreeList?page=4",
        "label": "4",
        "active": false
      },
      {
        "url": "https://onlinesim.io/api/getFreeList?page=5",
        "label": "5",
        "active": false
      },
      {
        "url": "https://onlinesim.io/api/getFreeList?page=6",
        "label": "6",
        "active": false
      },
      {
        "url": "https://onlinesim.io/api/getFreeList?page=7",
        "label": "7",
        "active": false
      },
      {
        "url": "https://onlinesim.io/api/getFreeList?page=8",
        "label": "8",
        "active": false
      },
      {
        "url": "https://onlinesim.io/api/getFreeList?page=9",
        "label": "9",
        "active": false
      },
      {
        "url": "https://onlinesim.io/api/getFreeList?page=10",
        "label": "10",
        "active": false
      },
      {
        "url": null,
        "label": "...",
        "active": false
      },
      {
        "url": "https://onlinesim.io/api/getFreeList?page=340",
        "label": "340",
        "active": false
      },
      {
        "url": "https://onlinesim.io/api/getFreeList?page=341",
        "label": "341",
        "active": false
      },
      {
        "url": "https://onlinesim.io/api/getFreeList?page=2",
        "label": "Вперёд »",
        "active": false
      }
    ],
    "next_page_url": "https://onlinesim.io/api/getFreeList?page=2",
    "path": "https://onlinesim.io/api/getFreeList",
    "per_page": 10,
    "prev_page_url": null,
    "to": 10,
    "total": 3404,
    "number": "9099317316",
    "country": 7
  },
  "ignore": "<p><strong>Номера телефонов, полученные на данном сервисе, не должны быть использованы в любых противозаконных действиях. Запрещено использовать номера телефонов для сайтов имеющих статус повышенного риска, к которым относятся: платежные системы, банки, кредитные организации, в том числе и некоторые букмекерские конторы, через которые возможна регистрация QIWI кошелька.</strong></p><p>Имена отправителей, от которых сервис не принимает СМС:</p><p>creditman, joyzaim.ru, qiwi_wallet, ideabank, zaimy.rf, colendi, banknote, paysending, cimb_bank, mrmoney@, paysenger, elecsnet, groshivsim, onefinrucom, telemaster, megafontv, web-zaim.ru, otkritie, rublimo.ru, soscredit, creditnice, ckasa24@, paycenter, rubliru.ru, bank.ipb, novikredyty, gosuslugi, banksoyuz, monebo.ru, freezaym.ru, monexy, moneyqlo.ru, ax-airbnk, cashtoyouru, dengidengi, bystro-zaim, credit7, gurucash, altyn-i@, BeelineClub, z_korona, erubli.ru, bankpekaosa, expobank, pimpay, 4slovo.ru, vodafone, cash4brands.ru, unocreditru, ad-walrsz, creditbox, dengas.ru, bankera, sgroshi7, 2mycard@, pumb, cash credit, finmoll@, kf.ua, megafon, migcredit, lovilave, mchsrt, paynamics, jk-jiopay, rosbank, centrzaim, slot78, denga34.ru, truemoney, concredit24, cash-u.com, expresdengi, manivam.ru, oschadbank, proleads, zaim-fin.ru, dit_dogm, moonpay@, joompay, gcash, kviku, ripplebank, fin2fin@, wallethub, shv.groshi, zaimer.kz, smartcredit, kaspikredit, enot.io, privatbank, budget4me34, vivid money, mangomoney, my_creditua, apollonzaym, boc, right-zaim, skrill, m-faktura, ininal, wmmini, helpkredit, sportbank, gotivo4ka, gpay, zaimol.ru, mili.ru, nicezaimonl, moniepoint, vkpay, 3339, zaimov.ru, thinkmoney, mistercash, otp bank, rsb.ru, anc, etzaimo.ru, migcred.ru, zaimika, tbankrot, skredit.su, bank_akcept, kit_notify, moneygo@, credit-pro, 20697, cash-u, kasa credit, likecentre, mycreditua, givemoney, kaspi gold, ukrpozyka, vitrinmoney, mts-bank, odobrim.ru, firstbank, miloan.ua, credit7.ru, stripe, accessbank, cash-1.ru, finanso_kz, aviracredit, homecredit, netcredit, mywallet, dinero, pochtabank, hyperpay, wooppay.com, activebc, ckasa, websetting, phonecode, kumo, denizbank, neteller, shgroshi, denvzaimy, zamzam, kreditker, 3karmana.ru, vtbconnect, otzovik, loanklik, airtel, trans kod, юнистрим, sberid, pluscardsru, payps, credinf24ru, qppiru,  kyivstar, monzo, creditax.ru, topcredit, cashpoint, good-zaimru, bankdki, dkb ag, uplata, goodmoneyru, krplusso.ru, microklad, monezp.ru, 9138, airbnk, qicard, ukrgasbank, wurussia, money-my.ru, icard, swedbank, wemabank, resobank, muchbetter, papazaim, jd-payzap, kredit-3000, credify@, zecredit, max.credit, ^zen$, dobrokredi, rostelecom, veomini@, denga, 0dobren0.ru, asakabank, moneyveo, nakartuuua, smsfinance, lime-zaim, mc_bbonus, el-plat.ru, alexcredit, sms2money, ferratum, paylaterph, moneyyourgo, am-airbnk, magnitpay, jysan bank, bank mellat, paysafecard, epa, boomaney.ru , greenmoney, glavfinans, cashrush, ya.invest, ecopayz, alfabank, fingo, tw team, mikrozaym, sovest, kazinfo, eurogroshi, kredizka.ru, joymoney, bkapmahe, mastercard, belkacredit, koronapay, globalcredi, medialid.ru, monobank, ezaem, imoney, tele2, vivus, modulbank, moneyextra, zaem48.ru, tobizaim, shvgroshi, pays.de, payzap, garantibbva, pozyka, tcktswallet, vipzaym, vivus.ru, 900, rublikom.ru, credit, mzaim24.ru, pancredit, finterra, bistrodenga.ru, kaspi.kz, banktochka, 24h.tv, simply, my-credit, bankamoney, proplati, tinkoff, rubli.ru, ekapusta, vostbank.ru, kaspi bank, beeline@, mtc.gid@, spoko, ubank, kreditcentr, yandexmoney, touch bank, dengimy.ru, gcb bank, paymaya@, psb, nuum, raiffeisen, zaimy24_7ru, mmoney24.ru, walletone, revolut@, monese, sirumobile, vloan, megafon_web, portmone, dengisrazu, grivni, dcredit, centrofin, usovromv, qiwi, zaimall24ru, rschs, vsemzaim, n26, my beeline, globalmoney, swizo, privatbank24, creditplus, way for pay, vzaimy24ru, kredit-24, payoneer, mobitel, payqr, prem-zaimru, zaim_online, creditter, gratapay, 9016451088, creditnice., free-zaim, slavzaim.ru, homebank, mzaim365.ru, boomaney.ru, paysend.com, home_credit, oncredit, lovizaim, gotivka, kapitalbank, web setting, seabank@, 9705844559, amzaim.ru, payeer.com, spishi.vip, indosat@, dzbr.ru@, sloncredit, fincredit, bankapp, zaymigo.com, dengga, wm check, bankffin, tendopay, cashni.ru, vm-mobikw, jm-payzap, weststein, wmcheck, zaimm365.ru, enot, darimcashru, halkbank, bp-ipaytm, turbomoney, money4you, rencredit, megafonpro, ccloan, cashdrive, advcash, 1clickmoney, clubzaim.ru, kerimov@, gazprombank, authy, sfurf.ru, mecred.ru, rnko card, gammamedia, creditport, alfa-bank, mtinkoff, unicredit, halkbank., megafon@, papara, wu russia, starkredit, e-cash, interkassa, whoosh.bike, izibank, sberbank.kz, mycredit, post kassa, mycredit.ua, creditkinsu, wirex, fortebank, platipotom, finkot.ru, cardcompact, paycell, jusan bank, creditstar, vm-homecr, mykreditpin, finspin, 5151, loanklik.ru, creditkasa, b-gift, finansbyrg, fastmoney, ad-payzap, pay-zaim.ru, unistream, paysera@, khan bank, bankera@, openbroker, 1020, tengeda.kz], paypal, teremzaim, sms.kaz@, todobank, credit_plus, fedorosu, fidorbank, cr911.ru, rightzaimon, zaimco, sberbank_ua, moneypay, mts.dengi, moneyman, 43676800325055, go2bank, 396, nakredit, whoosh, zaim_tobi, ruszaim24, cardsmobile, creditronic, halykbank, cashinsky, finme.ua, jaiz bank, mts.invest, unicom24, carduri, papaya, kredito24, spasibo, kyivstar, bestzaimo.ru, bistrodengi, klarna, vsezaimy24, wallet one, bilgimsj, smszaym.ru, ukrmoney, jiopay, kaspi pay, kto zvonil, kredit, 679, bankovo@, finica.ru, yoomoney, liqpay, concordbank, smartiway, 878, beeinfo, 6058464526, robotmoney, eurozaem, cashmo, cash22.ru, cryptowallet, bankvtb@, monebo, investrum, you banka, konga, mnedenga.ru, dit_emp@, skycash, paygoo, credit-help, sbrf, rshb, swip.one, moneysend, alizaim, finmarket, wink, inbank, wmru, mobi.dengi, vakifbank, abank, qppi.ru, frisbi24, denegna.ru, webbankir, colibrideng, needzaim.ru, mtc, vivadengi, Kyivstar, a-business, bp-paytmb, 131881, na kartu, ckassa.ru, qiwi wallet, egroshicom, lycamobile, platiza, beelineroam, safebank.ru, leupay, paysend, ddmoney.ru, jd-dbsbnk, ffcredit, [mywallet], tengo, ukredit, slimpay, gofingo, beeline, creditseven, 243897238, 1711, zaymigo@, boostra@, fin4go, vtb, much money, bank_dom.rf, 0500, sdb bank, ja-jiopay, binbankcard, vm-pnbacs, skb-bank, debetkredit, paycam, rubasy.ru, av-airbnk, kasacredit, alfa, activ, zaymer.ru, ay-airbnk, dengisrazy, [money2dayru], platiza.ru, yota, keny.cc, citibank, forzacredit, crediton, wise, 99deneg.ru, easypay, vozmi365.ru, 1cashu.ru, 4915730302462, jy-jiopay, notify_kz, neocredit, extracredi, onlinecred, 1415, bankasi, smartbank, ruszaim24ru, unionbank, sbankers, zaimm24.ru, smartmoney, gigalifeapp, ziraatbank, kupinekopi, infobankcrp, getzaim24ru, vimpay, zaimy24.ru, sumup, webmoney.ua, moynalog, tx-walrsz, cash app, 2017536013, rnko_card, metrokredit, moneyhy.ru, creditup, bankovo.ru, creditka, bankacredit, cec bank, dengi dozp, atzaim.ru, rncb, webmoney, solcredito, globusbank, mchs, ae-airbnk, ad-kblbnk, mobikw, mtspodpiski, goodcredit, ezaem.ru, solarisbank, zaim, zen.com, 111, transferwise, big-zaim.ru, pscb, touch_bank, kontist, dit_moslog, robmoney.ru, qiwiinfo, 12264019433, zaimexpress, mos.com.ru, ipakyuli, gojek, cashberry, credit25000, microcash, planetacash, ax-mobikw, 37128914187, mccquattro, rocketbank, +447385577408, arbuzo, sovcombank, kachaigrosi, zajavka@, mos.ru, corezaimonl, sharpay, khanbank, visa, qiwiwallet, wm mini, fns_russia, moneza, akbank, turbozaim, moneyboom, touchbank, unicom24ru, khan, cpzaim.ru, webzaim-mkk, centrzaimov, uazaimi@, dozarplati, platizaru, dukascopy, telepay, avantmoney, rubliner.ru</p>"
}

Code Samples

Generating examples...