API

Application Programming Interface

In order to start using our API, you need to register and get a secret key.
Run the request in the browser using the received secret key:

https://imeidb.xyz/api/imei/{imei}?token={token}&format={format}

We provide two formats for providing data: json and xml. By default the information is displayed in json format.

You can also transfer a token through the X-Api-Key header. This can be useful if you do not want to show the token in the used query.

Response example:

{
  "success": true,
  "query": 353893101224013,
  "data": {
    "tac": 35389310,
    "serial": 122401,
    "controlNumber": 3,
    "valid": true,
    "device_id": 9846,
    "device_image": "https://fdn2.gsmarena.com/vv/bigpic/apple-iphone-11-pro.jpg",
    "device_spec": {
      "sim_slots": 1,
      "os": "iOS 13",
      "os_family": "iOS",
      "aliases": [
        "A2218",
        "A2161",
        "A2220"
      ],
      "bluetooth": [
        "5.0",
        "A2DP",
        "LE"
      ],
      "usb": [
        "2.0",
        "proprietary reversible connector"
      ],
      "wlan": [
        "Wi-Fi 802.11 a/b/g/n/ac/ax",
        "dual-band",
        "hotspot"
      ],
      "nfc": true,
      "speed": [
        "HSPA 42.2/5.76 Mbps",
        "LTE-A 1.6 Gbps DL",
        "EV-DO Rev.A 3.1 Mbps"
      ],
      "nettech": [
        "GSM",
        "CDMA",
        "HSPA",
        "EVDO",
        "LTE"
      ]
    },
    "name": "Apple iPhone 11 Pro Max",
    "brand": "Apple",
    "model": "iPhone 11 Pro Max",
    "models": [
      "iPhone 11 Pro Max"
    ],
    "manufacturer": "Apple Inc",
    "type": "Smartphone",
    "blacklist": {
      "status": false
    },
    "frequency": [
        "CDMA2000",
        "LTE FDD BAND 1",
        "LTE FDD BAND 2",
        "...",
        "LTE FDD BAND 25",
        "LTE FDD BAND "
    ]
  }
}

That's all! Can be used.

List of available type values

To improve integration, you can use the type field. We support the following types of devices:

[
  "Handheld",
  "Portable(include PDA)",
  "Smartphone",
  "Mobile Phone/Feature phone",
  "Vehicle",
  "Module",
  "Modem",
  "Dongle",
  "IoT Device",
  "WLAN Router",
  "Tablet",
  "Connected Computer",
  "Wearable",
  "e-Book",
  "Mobile Test Platform"
]


Balance tracking

For the smooth operation of the service, you need to replenish the balance on time, and to simplify the balance control, use the method:

https://imeidb.xyz/api/balance?token={token}

Response:

{
    "balance": 100.26,
    "currency": "USD"
}


Error processing

If invalid data is transferred or numbers do not exist in our database, you will get an error. Example:

{
    "success": false,
    "message": "Your request was made with invalid credentials.",
    "code": 401
}
CodeMessageDescription
401 Your request was made with invalid credentials.
402 Out of money, please top up your balance.
429 Rate limit exceeded. Requests per minute exceeded. (For clients with limits enabled)
460 Invalid IMEI IMEI must pass the Luhn algorithm check.


PHP SDK

For PHP, we provide a SDK for quick and easy access to our API. Detailed information you can find here: https://github.com/ImeiDB/SDK