Mexican Phone Number API (IFT)

Features

✓ Validation & Formatting

Validate Mexican number format and standardize to E.164 international format.

✓ Carrier Identification

Identify telecommunications carrier (Telcel, AT&T, Movistar, etc.) using IFT base.

✓ IFT Database

Official information from Federal Telecommunications Institute regularly updated.

✓ Number Type

Classify numbers as mobile, landline, toll-free (800), or special.

API Endpoint

GET https://api.tlaloc.sh/mx/v1/phone?number={number}

Parameters

Parameter	Type	Required	Description
`number`	string	Yes	Phone number (10 digits)

Example Request

You need a Bearer API key (prefix tlmx_) generated in the console.

curl -X GET "https://api.tlaloc.sh/mx/v1/phone?number=8112345678" \
  -H "Authorization: Bearer tlmx_YOUR_API_KEY"

Example Response

[
  {
    "clave_censal": "190390001",
    "poblacion": "MONTERREY",
    "municipio": "MONTERREY",
    "estado": "NUEVO LEÓN",
    "region": 2,
    "nir": 81,
    "serie": 1234,
    "asl": 4,
    "tipo_red": "MOVIL",
    "modalidad": "MPP",
    "razon_social": "RADIOMOVIL DIPSA SA DE CV",
    "numeracion_inicial": "8112345000",
    "numeracion_final": "8112345999",
    "ocupacion": 1000,
    "fecha_asignacion": "2021-03-10",
    "fecha_consolidacion": null,
    "fecha_migracion": null,
    "presuscripcion": null,
    "nir_anterior": null
  }
]

Use Cases

User Verification

Validate numbers during registration with SMS codes.

Call Centers

Identify carrier to optimize call costs.

SMS Marketing

Validate numbers before sending bulk SMS campaigns.

Fraud Prevention

Detect invalid or suspicious numbers in transactions.

View Full Documentation Contact Sales

Frequently Asked Questions

What does the API return for a phone number?

Data from the IFT National Numbering Plan: carrier (legal name), network type (fixed or mobile), modality, town, municipality and state of the number series, NIR, and the assignment and migration dates of the numbering block.

Does it distinguish landlines from mobile numbers?

Yes, the tipo_red field tells you whether the series is fixed or mobile — useful to decide between SMS and voice, or to filter out numbers that can't receive messages.

Where does the data come from?

From the official numbering catalog of Mexico's Federal Telecommunications Institute (IFT), refreshed as the institute publishes changes.

How much does it cost?

$0.01 MXN (0.01 units) per lookup, VAT included — priced to clean entire databases without cost being a factor.

What is this API typically used for?

Cleaning contact lists for SMS and voice campaigns, identifying the carrier before routing traffic, detecting numbers that are well-formed but belong to no assigned series, and segmenting contacts by region.

Phone Numbers API