[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"api-page:mexico-phone-carrier-lookup":3},{"status":4,"api":5,"seo":199},"success",{"blocked":6,"description":7,"about":8,"stats":9,"name":11,"title":12,"slug":13,"logo":14,"created_at":15,"agent":16,"user":28,"endpoint_groups":31,"faqs":140,"features":150,"periodic_plans":151,"payasyougo_plans":197,"releases":198,"last_updated":18},false,"Current carrier of any Mexican phone number with number portability applied, plus mobile vs. landline, state and municipality.","Look up any 10-digit Mexican phone number and get its **current carrier with number portability applied**, whether it is **mobile or landline**, and the **state and municipality** of its numbering range, in one call.\n\n## What you get\n\n- **Current carrier, not the original one.** More than 80 million Mexican numbers have been ported. Every lookup is checked against the number portability database, updated daily, and ported numbers also return the previous carrier.\n- **Mobile or landline.** Since 2019 Mexican numbers carry no mobile prefix, and libphonenumber returns `FIXED_LINE_OR_MOBILE` for all of them. This API returns `tipo`: `movil` or `fijo`.\n- **Location.** State, municipality and locality of the numbering range, plus the CPP/MPP modality.\n- **Dialing formats.** National, international (+52) and from the United States.\n- **No guessing.** If a number is ported to a carrier that cannot be identified, `operador_identificado` is `false`.\n- **Area codes.** `/lada/{nir}` returns the states and municipalities served by any Mexican area code.\n\n## Common uses\n\n- Route SMS and calls by the real carrier.\n- Pick the right carrier for airtime top-ups.\n- Clean contact lists before SMS or WhatsApp campaigns: drop landlines and unassigned numbers.\n- Validate sign-ups: the number exists, is mobile and matches the declared region.\n\n## Example\n\n`GET /telefono/4521158653` returns `MOVISTAR` as the current carrier, ported from `TELCEL`, mobile, in Uruapan, Michoacán.\n\n## Data sources\n\nMexico's National Numbering Plan (CRT, formerly IFT) and the number portability database, updated daily.",{"score":10},"2.67","Mexico Phone Carrier Lookup","Mexico Phone Carrier Lookup API","mexico-phone-carrier-lookup","https://cdn.jojapi.com/api/b35ac989-2b03-4c34-8227-1fa405a08926","2026-09-24 17:57:46",{"enabled":17,"closed":18,"request_enabled":6,"catalog_url":19,"discovery_url":20,"directory_url":21,"rails":22,"networks":25,"docs":27},true,null,"https://gutkc.jojapi.net/_jojapi/agent/plans","https://gutkc.jojapi.net/.well-known/x402","https://agents.jojapi.net/apis/mexico-phone-carrier-lookup",[23,24],"x402","mpp",[26],"eip155:8453","https://docs.jojapi.com/consumers/agents",{"nick":29,"name":30,"verified":6,"website":18},"edgar-uribe","Edgar Uribe",[32],{"endpoints":33,"name":139,"description":40,"ungrouped":17,"open":6},[34,85,114],{"blocked":6,"hidden":6,"agent_price":18,"credits":18,"flexible_credits_description":18,"consumptions":35,"description":42,"method":43,"name":44,"url_path":45,"root_url":46,"parameters":47,"responses":63,"result_stats":81},[36],{"name":37,"slug":38,"cost":39,"label":40,"avg":41},"Requests","requests","1","",1,"Returns the current carrier of a 10-digit Mexican number with number portability applied (and the previous carrier when the number was ported), whether it is mobile or landline, the state, municipality and locality of its numbering range, its CPP/MPP modality and ready-made dialing formats. If the current carrier cannot be identified, `operador_identificado` is `false` and `operador` is `DESCONOCIDO` instead of a guess.","GET","Phone number lookup","/telefono/{numero}","https://gutkc.jojapi.net",{"url":48,"header":49,"post":56,"body":57,"path":58},[],[50],{"key":51,"is_auth":17,"example":52,"example_disabled":17,"example_type":53,"name":54,"description":52,"required":17,"always_error":55},"X-JoJAPI-Key","You must log in to get API key","string","JoJ API Key","Please log in to get API key",[],[],[59],{"key":60,"example":61,"example_disabled":6,"example_type":53,"value_type":53,"enum_values":18,"name":40,"description":62,"required":17},"numero","4521158653","10-digit Mexican phone number, area code included, digits only. Example: 4521158653",[64,73],{"status":65,"status_code":66,"description":67,"schema":68,"examples":69,"example":72},"200",200,"Number found in the national numbering plan","{\"type\":\"object\",\"properties\":{\"numero\":{\"type\":\"string\",\"description\":\"Number looked up (10 digits)\"},\"nir\":{\"type\":\"string\",\"description\":\"Area code (lada), 2 or 3 digits\"},\"operador\":{\"type\":\"string\",\"description\":\"Legal name of the CURRENT carrier (portability applied), or DESCONOCIDO\"},\"nombre_corto\":{\"type\":\"string\",\"description\":\"Brand of the current carrier (e.g. TELCEL, MOVISTAR, AT&T), or DESCONOCIDO\"},\"estado\":{\"type\":\"string\",\"description\":\"State of the numbering range\"},\"municipio\":{\"type\":\"string\",\"description\":\"Municipality of the numbering range\"},\"asentamiento\":{\"type\":\"string\",\"description\":\"Locality of the numbering range\"},\"modalidad\":{\"type\":\"string\",\"description\":\"cpp (calling party pays), mpp (mobile party pays) or fijo\"},\"tipo\":{\"type\":\"string\",\"enum\":[\"movil\",\"fijo\"],\"description\":\"Line type: mobile (movil) or landline (fijo)\"},\"portado\":{\"type\":\"boolean\",\"description\":\"True when the number was ported to another carrier\"},\"operadora_anterior\":{\"type\":\"string\",\"description\":\"Legal name of the previous carrier when ported\"},\"operadora_anterior_corto\":{\"type\":\"string\",\"description\":\"Brand of the previous carrier when ported\"},\"code\":{\"type\":\"string\",\"description\":\"Portability code of the current carrier (empty when not ported)\"},\"portado_verificado\":{\"type\":\"boolean\",\"description\":\"False only if the portability database could not be checked for this request\"},\"operador_identificado\":{\"type\":\"boolean\",\"description\":\"False when the number is ported to a carrier that cannot be identified\"},\"marcacion\":{\"type\":\"object\",\"description\":\"Dialing formats\",\"properties\":{\"nacional\":{\"type\":\"string\",\"description\":\"Within Mexico\"},\"internacional\":{\"type\":\"string\",\"description\":\"International format (+52)\"},\"estados_unidos\":{\"type\":\"string\",\"description\":\"Dialing from the United States\"}}}}}",[70],{"name":71,"summary":40,"description":40,"example":72},"default","{\"numero\":\"4521158653\",\"nir\":\"452\",\"operador\":\"PEGASO PCS, S.A. DE C.V.\",\"estado\":\"Michoac\\u00e1n de Ocampo\",\"municipio\":\"Uruapan\",\"asentamiento\":\"URUAPAN\",\"modalidad\":\"cpp\",\"nombre_corto\":\"MOVISTAR\",\"tipo\":\"movil\",\"portado\":true,\"operadora_anterior\":\"RADIOMOVIL DIPSA, S.A. DE C.V.\",\"operadora_anterior_corto\":\"TELCEL\",\"code\":\"118\",\"portado_verificado\":true,\"operador_identificado\":true,\"marcacion\":{\"nacional\":\"4521158653\",\"internacional\":\"+52 4521158653\",\"estados_unidos\":\"011 52 4521158653\"}}",{"status":74,"status_code":75,"description":76,"schema":77,"examples":78,"example":80},"404",404,"The number is not assigned in the national numbering plan, or it is not 10 digits","{\"type\":\"object\",\"properties\":{\"message\":{\"type\":\"string\",\"description\":\"What went wrong\"}}}",[79],{"name":71,"summary":40,"description":40,"example":80},"{\"message\":\"El n\\u00famero 9999999999 no existe.\"}",{"x2":82,"x3":83,"x4":83,"x5":83,"uptime":82,"avg_latency":84,"avg_credits":83},"100.00","0.00","476",{"blocked":6,"hidden":6,"agent_price":18,"credits":18,"flexible_credits_description":18,"consumptions":86,"description":88,"method":43,"name":89,"url_path":90,"root_url":46,"parameters":91,"responses":102,"result_stats":18},[87],{"name":37,"slug":38,"cost":39,"label":40,"avg":18},"Returns the states and municipalities served by a Mexican area code (lada, 2 or 3 digits) and how many numbering ranges it has assigned.","Area code lookup","/lada/{nir}",{"url":92,"header":93,"post":95,"body":96,"path":97},[],[94],{"key":51,"is_auth":17,"example":52,"example_disabled":17,"example_type":53,"name":54,"description":52,"required":17,"always_error":55},[],[],[98],{"key":99,"example":100,"example_disabled":6,"example_type":53,"value_type":53,"enum_values":18,"name":40,"description":101,"required":17},"nir","415","Mexican area code (lada), 2 or 3 digits. Examples: 55, 415",[103,109],{"status":65,"status_code":66,"description":104,"schema":105,"examples":106,"example":108},"Area code found","{\"type\":\"object\",\"properties\":{\"lada\":{\"type\":\"string\",\"description\":\"Area code\"},\"estados\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"States served\"},\"municipios\":{\"type\":\"array\",\"description\":\"Municipalities served\",\"items\":{\"type\":\"object\",\"properties\":{\"municipio\":{\"type\":\"string\"},\"estado\":{\"type\":\"string\"}}}},\"series_asignadas\":{\"type\":\"integer\",\"description\":\"Numbering ranges assigned to the area code\"}}}",[107],{"name":71,"summary":40,"description":40,"example":108},"{\"lada\":\"415\",\"estados\":[\"Guanajuato\"],\"municipios\":[{\"municipio\":\"San Miguel de Allende\",\"estado\":\"Guanajuato\"}],\"series_asignadas\":392}",{"status":74,"status_code":75,"description":110,"schema":77,"examples":111,"example":113},"The area code does not exist",[112],{"name":71,"summary":40,"description":40,"example":113},"{\"message\":\"La lada 111 no existe.\"}",{"blocked":6,"hidden":6,"agent_price":18,"credits":18,"flexible_credits_description":18,"consumptions":115,"description":116,"method":43,"name":117,"url_path":118,"root_url":46,"parameters":119,"responses":126,"result_stats":18},[],"Service health and the size of the loaded data (numbering ranges, area codes and states).","Service status","/status",{"url":120,"header":121,"post":123,"body":124,"path":125},[],[122],{"key":51,"is_auth":17,"example":52,"example_disabled":17,"example_type":53,"name":54,"description":52,"required":17,"always_error":55},[],[],[],[127,132],{"status":65,"status_code":66,"description":128,"schema":18,"examples":129,"example":131},"Service is up",[130],{"name":71,"summary":40,"description":40,"example":131},"{\"ok\":true,\"version\":\"2.1.0\",\"fuente\":\"Plan Nacional de Numeraci\\u00f3n (IFT) + ABD de portabilidad\",\"datos\":{\"rangos_numeracion\":177934,\"ladas\":413,\"estados\":32}}",{"status":133,"status_code":134,"description":135,"schema":77,"examples":136,"example":138},"503",503,"Service temporarily unavailable",[137],{"name":71,"summary":40,"description":40,"example":138},"{\"message\":\"Servicio no disponible\"}","Ungrouped Endpoints",[141,144,147],{"question":142,"answer":143},"Does it return the current carrier or the original one?","The current one. Every number is checked against Mexico's number portability database (more than 80 million ported numbers, updated daily). When a number was ported, the response also includes the previous carrier (`operadora_anterior_corto`). If the number was ported to a carrier that cannot be identified, `operador_identificado` is `false` and `operador` is `DESCONOCIDO`, so you never get a guess.",{"question":145,"answer":146},"Can it tell whether a Mexican number is mobile or landline?","Yes. Since 2019 Mexican numbers carry no mobile prefix, so libphonenumber returns `FIXED_LINE_OR_MOBILE` for every Mexican number. This API looks each number up in the national numbering plan and returns `tipo`: `movil` or `fijo`, plus the state, municipality and locality of its numbering range.",{"question":148,"answer":149},"How fresh is the data?","The number portability database is updated every day with the new ports (around 40,000 numbers a day, roughly 1.2 million a month). Numbering ranges, carriers and locations come from Mexico's official National Numbering Plan (CRT, formerly IFT). Use the `/status` endpoint to check the service and the size of the loaded data.",[],[152,168,178,187],{"type":153,"slug":154,"blocked":6,"period":155,"currency":156,"pricing":157,"rate_limit":161,"objects":162,"name":166,"display_name":166,"features":167},"periodic","9d53wt97z9vmtrqtnci9l12x","1 MONTH","usd",{"price":158,"credits":158,"past_due_timeout_num":159,"past_due_timeout_type":160},0,3,"DAY",{"max_requests":18,"time_window":18},[163],{"id":164,"name":37,"slug":38,"quota":165,"tiers":18},"n5087cffe",100,"Basic",[],{"type":153,"slug":169,"blocked":6,"period":155,"currency":156,"pricing":170,"rate_limit":172,"objects":173,"name":176,"display_name":176,"features":177},"8zqjzx278ps25sd1y9sejquk",{"price":171,"credits":158,"past_due_timeout_num":159,"past_due_timeout_type":160},25,{"max_requests":18,"time_window":18},[174],{"id":164,"name":37,"slug":38,"quota":175,"tiers":18},2500,"Pro",[],{"type":153,"slug":179,"blocked":6,"period":155,"currency":156,"pricing":180,"rate_limit":181,"objects":182,"name":185,"display_name":185,"features":186},"9kix4242c09fn39vts6p9197",{"price":165,"credits":158,"past_due_timeout_num":159,"past_due_timeout_type":160},{"max_requests":18,"time_window":18},[183],{"id":164,"name":37,"slug":38,"quota":184,"tiers":18},10000,"Ultra",[],{"type":153,"slug":188,"blocked":6,"period":155,"currency":156,"pricing":189,"rate_limit":191,"objects":192,"name":195,"display_name":195,"features":196},"pysmr39rv220m861z3kaoyj8",{"price":190,"credits":158,"past_due_timeout_num":159,"past_due_timeout_type":160},500,{"max_requests":18,"time_window":18},[193],{"id":164,"name":37,"slug":38,"quota":194,"tiers":18},60000,"Mega",[],[],[],{"canonical":200,"page_title":201,"meta":202},"https://jojapi.com/hub/api/mexico-phone-carrier-lookup","Mexico Phone Carrier Lookup API Documentation & Playground - JoJ API",{"description":7,"keywords":203},"API,API Documentation,API Playground,Plans & Pricing,Mexico Phone Carrier Lookup,edgar-uribe"]