Documentation

Currently, exclusive API access is available solely in our PAID version. For details on the BASIC API and pricing, please refer to our Price List.

API connection is pivotal, enabling seamless order submissions on connected websites and prompt replies. Upon registration, an automatically generated API key grants immediate access, allowing personalized requests while being mindful of specific limitations for optimal system performance.

To retrieve phone information, please initiate a POST request to:

https://www.imeiapi.org/

Please specify the parameters in the POST data.

API Key: in paid version
imei: enter IMEI numer

A form demonstration to retrieve phone information through the browser using an API key:

<form action="https://www.imeiapi.org/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.org/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.org/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);
});

An illustration of a BASIC API result – refer below for pricing specifics regarding the basic API.

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

An instance showcasing a FULL API result – should you need more parameters beyond the basic information mentioned earlier, please contact us for pricing details.

{
"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"
}

Error support:
All errors are displayed 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

API Key status check:

https://www.imeiapi.org/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}