IMSI parse (MCC/MNC) API

Parses an IMSI into MCC (country), MNC (network), and MSIN, honoring 2- or 3-digit MNC. Answers 'What is the MCC/MNC of this IMSI?', 'How do I split this IMSI?'.

Price$0.02per request

MethodPOST

Route/v1/validate/imsi

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

imsimccmncmsincellularvalidatesubscribermobileparse

API URLhttps://x402.hexl.dev/v1/validate/imsi

Integration docs

Example request

{
  "imsi": "310150123456789",
  "mncDigits": 3
}

Example response

{
  "valid": true,
  "reason": "IMSI parsed: MCC 310, MNC 150 (3-digit), MSIN length 9.",
  "normalized": "310150123456789",
  "mcc": "310",
  "mnc": "150",
  "msin": "123456789",
  "mncDigits": 3
}

Input schema

{
  "type": "object",
  "required": [
    "imsi"
  ],
  "properties": {
    "imsi": {
      "type": "string",
      "description": "6-15 digit International Mobile Subscriber Identity.",
      "examples": [
        "310150123456789"
      ]
    },
    "mncDigits": {
      "type": "number",
      "description": "2 or 3 (default 2).",
      "examples": [
        3
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}