Documentation

Please be advised that API requests are subject to rate limitations. Kindly refrain from sending more than 4 requests simultaneously and ensure that your total requests per minute remain below 100. Exceeding these limits may result in automatic IP blocking.

As of now, API access is exclusively offered in our PAID version, and the pricing details for the BASIC API are provided at Price List:

1. For phone information retrieval, kindly initiate a POST request to:

   https://www.imeiapi.net/

2. In the POST data, kindly specify the parameters:

   API Key: in paid version
   imei: enter IMEI numer

   A demonstration form for obtaining phone information in the browser utilizing an API key:

   <form action="https://www.imeiapi.net/checkimei" method="POST">
   API Key: <input type="text" name="key" />
   Imei: <input type="text" name="imei" />
   <button type="submit">Check!</button>
   </form>

   CURL

   curl -X POST https://www.imeiapi.net/checkimei/ -H 'cache-control: no-cache' -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' -F imei={imei-to-check-here} -F key={your-api-key-here}

   NODE.JS

   var request = require("request");
   var options = { method: 'POST',
   url: 'https://www.imeiapi.net/checkimei/',
   headers:
   { 'cache-control': 'no-cache',
   'content-type': 'multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' },
   formData:
   { imei: 'imei-to-check-here',
   key: 'your-api-key-here' } };
   request(options, function (error, response, body) {
   if (error) throw new Error(error);
   console.log(body);
   });

   Example of a BASIC result obtained through API – see below for pricing details for the basic API.

   {
   "imei":"01341000008XXXX", 
   "brand": "APPLE", 
   "model": "iPhone 5"
   }

   Example of a FULL result retrieved through the API – please reach out to us for pricing details if you require additional parameters beyond the basic information provided above.

   {
   "imei": "35XXXXXXXXXXXXX",
   "imei_parts": {
   "fac": "XX",
   "cd": "X",
   "snr": "XXXXXX",
   "tac": "35XXXX"
   },
   "brand": "NOKIA",
   "info": {
   "weight": 130.0,
   "battery": [
   "Li-Ion",
   850
   ],
   "qwerty": false,
   "year": [
   "2002",
   "09"
   ],
   "talk_time_umts": 0.0,
   "stand_by": 200.0,
   "touch_scr": false,
   "size": {
   "width": 57.0,
   "thickness": 26.0,
   "height": 130.0
   },
   "wifi_hotspot": false,
   "cpu_clock": 104.0,
   "other_band": [],
   "build": "Classic",
   "tel_func": false,
   "lan": false,
   "talk_time": 4.0,
   "int_memory": "4",
   "gsm_band": [
   "900",
   "1800",
   "1900"
   ],
   "memory_card": [
   "MMC",
   0
   ],
   "umts_band": [],
   "hsdpa_band": [],
   "display": {
   "color": [
   true,
   "4K"
   ],
   "type": "LCD",
   "size": {
   "width": 176,
   "inches": 2.1,
   "height": 208
   }
   },
   "lan_ports": null,
   "os": "Symbian 6.1",
   "cpu": "ARM9"
   },
   "model": "3650"
   }

3. Error suport:
   Every error is presented in JSON format.
   For example:

   {'error': 'Incorrect username/password'}
   {'error': 'Account blocked'}
   {'error': 'Missing username/password'}
   {'error': 'Exceeded the limit'}
   {'error': 'IMEI: 35XXXXXXXXXXXXX not found'}
   {'error': 'IMEI cannot be empty'}
   {"errors": "API key invalid or disabled"} // HTTP STATUS: 403
   {"errors": "API key not activated or expired"} // HTTP STATUS: 403
   {"errors": "Hourly limit exceeded"} // HTTP STATUS: 429
   {"errors": "Daily limit exceeded"} // HTTP STATUS: 429
   

4. API Key status check:

   https://www.imeiapi.net/status?key={YOUR_API_KEY}

   Sample result:

   {"Has access": true, "Activation date": "2018-10-29", "Expiration date": "2018-12-30", "Checks left (hour)": "No limit", "Checks left (day)": "No limit", "Checks left (month)": 4996}