Skip to main content

Vérification IMEI

Endpoint​

POST /api/imei

En-têtes requis​

Content-Type: application/json
api-key: VOTRE_CLE_API

Paramètres de la requête​

ParamètreTypeRequisDescription
imeiStringOuiNuméro IMEI à vérifier. Doit contenir exactement 15 chiffres et passer la validation Luhn.
serviceIntegerNonIdentifiant numérique du service IMEI à utiliser. Si non fourni, le service par défaut configuré côté serveur est utilisé.

Exemple de requête​

{
  "imei": "359675691438127",
  "service": 0
}

Réponse réussie (200)​

Le format de data.result dépend du service appelé. data reflète exactement la réponse du fournisseur.

Exemple — Service 0 (Basic IMEI Check)​

{
  "success": true,
  "data": {
    "id": 171277913,
    "ulid": "01KQX6G13F1G0QV1CQX2T16ZF7",
    "status": "Done",
    "service": "Basic IMEI Check",
    "service_id": 0,
    "created_at": "2026-05-06T01:10:14.128029+02:00",
    "imei": "359675691438127",
    "imei2": null,
    "sn": null,
    "phone_number": null,
    "text": null,
    "token_key": "73e***cb7",
    "token_request_price": "0.020",
    "result": {
      "imei": "359675691438127",
      "brand_name": "APPLE",
      "model": "iPhone 14"
    },
    "is_custom_result": false,
    "requested_at": "2026-05-06T01:10:14.127615+02:00",
    "custom_format_response": null,
    "processing_countdown": 20
  }
}

Exemple — Service 12 (APPLE: Warranty Check)​

{
  "success": true,
  "data": {
    "id": 171276981,
    "ulid": "01KQX63WNW53MFNWKGQHNFETJM",
    "status": "Done",
    "service": "APPLE: Warranty Check",
    "service_id": 12,
    "created_at": "2026-05-06T01:03:36.380728+02:00",
    "imei": "359675691438127",
    "imei2": null,
    "sn": null,
    "phone_number": null,
    "text": null,
    "token_key": "73e***cb7",
    "token_request_price": "0.040",
    "result": {
      "model": "iPhone 14",
      "imei_sn": "359675691438127",
      "activation_status": "Activated",
      "warranty_status": "Out Of Warranty",
      "estimated_purchase_date": "2022-12-25",
      "telephone_technical_support": "Expired",
      "repairs_and_service_coverage": "Expired",
      "repairs_and_service_expiration_date": "2023-12-25",
      "applecare_eligible": "No",
      "valid_purchase_date": "Yes",
      "replaced_by_apple": "No",
      "registered_device": "Yes",
      "refurbished_device": "No",
      "loaner_device": "No",
      "created_at": "2026-05-05 23:03 UTC",
      "device_is_activated": "true"
    },
    "is_custom_result": false,
    "requested_at": "2026-05-06T01:03:36.379200+02:00",
    "custom_format_response": null,
    "processing_countdown": 20
  }
}

Champs de réponse :

  • success : true si la vérification a réussi
  • data.id / data.ulid : Identifiants uniques de la requête côté fournisseur
  • data.status : Statut de traitement (Done lorsque le résultat est immédiat)
  • data.service / data.service_id : Service utilisé pour la vérification
  • data.result : Résultat retourné par le fournisseur (structure variable selon le service)
  • data.token_request_price : Prix de la requête en jetons
  • data.processing_countdown : Temps estimé de traitement (secondes)

Réponse en cours de traitement (202)​

{
  "success": true,
  "pending": true,
  "data": {
    "message": "Request is being processed",
    "history_id": 123456,
    "ulid": "01HXXXXXXXXXXXXXX"
  },
  "message": "IMEI lookup is still being processed by the provider. Try again later with the returned id/ulid."
}

Conservez le history_id / ulid pour suivre la requête côté fournisseur.

Réponses d'erreur​

400 - Requête invalide​

{
  "success": false,
  "message": "IMEI is required"
}
{
  "success": false,
  "message": "Invalid IMEI. Must be exactly 15 digits and pass the Luhn checksum."
}
{
  "success": false,
  "message": "Service ID is required (pass `service` in the request or set IMEI_INFO_DEFAULT_SERVICE_ID)."
}

401 - Clé API manquante​

{
  "message": "API key is missing"
}

402 - Rejet par le fournisseur​

{
  "success": false,
  "message": "Request is too expensive.",
  "data": { "detail": "Request is too expensive." }
}
{
  "success": false,
  "message": "Service not found",
  "data": { "error": "Service not found" }
}

403 - Clé API invalide​

{
  "success": false,
  "message": "Invalid API key"
}

403 - Application suspendue​

{
  "success": false,
  "message": "App is suspended. Cannot perform IMEI lookup."
}

403 - Service IMEI non activé​

{
  "success": false,
  "message": "IMEI service is not enabled for this app (is_imei is not true)."
}

405 - Méthode non autorisée​

{
  "success": false,
  "message": "Method Not Allowed"
}

500 - Provider non configuré​

{
  "success": false,
  "message": "IMEI provider is not configured"
}

502 - Provider injoignable​

{
  "success": false,
  "message": "IMEI provider unreachable"
}