Documentation / Endpoints / POST /api/imei

POST /api/imei

Enterprise

Perform real-time IMEI, serial number, or ESN risk assessment including blacklist status, carrier lock, and device identification.

Authentication

Requires Enterprise tier access.

Request Body

FieldTypeRequiredDescription
identifierstringIMEI, serial number, or ESN
identifier_typestring"imei", "serial", or "esn"

Example Request

curl -X POST "https://api.souratlas.io/api/imei" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "identifier": "358742012345678",
    "identifier_type": "imei"
  }'

Example Response

{
  "success": true,
  "data": {
    "lookup_id": "lookup_abc123xyz",
    "identifier": "358742012345678",
    "identifier_type": "imei",
    "timestamp": "2024-01-15T10:30:00Z",
    "device_match": {
      "confidence": 95,
      "matched_device_id": "apple-iphone-14-pro",
      "matched_device_name": "Apple iPhone 14 Pro",
      "matched_variant_id": "var_iphone14pro_128_black",
      "matched_variant_name": "128GB Space Black"
    },
    "blacklist_status": "clean",
    "carrier_lock": "unlocked",
    "carrier_name": null,
    "risk_score": 15,
    "risk_level": "low",
    "gsma_status": "clean",
    "ctia_status": "clean",
    "reported_lost_stolen": false,
    "activation_lock": false,
    "source": "mock",
    "freshness": "real-time",
    "cache_age_minutes": null
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

Response follows the IMEILookupResult schema.

GET /api/imei

Retrieve your organization's IMEI lookup history.

Query Parameters

  • limit (integer, optional): Number of results (default: 50, max: 100)

Error Responses

StatusError CodeDescription
400VALIDATION_ERRORInvalid request body or IMEI format
401UNAUTHORIZEDMissing or invalid API key
403FORBIDDENRequires enterprise tier access
429RATE_LIMIT_EXCEEDEDRate limit exceeded
500INTERNAL_ERRORInternal server error
503SERVICE_UNAVAILABLEIMEI lookup service temporarily unavailable