{"openapi":"3.2.0","info":{"title":"Mexico Phone Carrier Lookup API","description":"Current carrier of any Mexican phone number with number portability applied, plus mobile vs. landline, state and municipality.","version":"1.0.0"},"servers":[{"url":"https://gutkc.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"x-agent-commerce":{"catalog_url":"https://gutkc.jojapi.net/_jojapi/agent/plans","discovery_url":"https://gutkc.jojapi.net/.well-known/x402","directory_url":"https://agents.jojapi.net/apis/mexico-phone-carrier-lookup","docs":"https://docs.jojapi.com/consumers/agents"},"paths":{"/telefono/{numero}":{"get":{"operationId":"get_telefono_numero","summary":"Phone number lookup","description":"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.","responses":{"200":{"description":"Number found in the national numbering plan","content":{"application/json":{"schema":{"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"}}}}},"example":{"numero":"4521158653","nir":"452","operador":"PEGASO PCS, S.A. DE C.V.","estado":"Michoacán 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"}}}}},"404":{"description":"The number is not assigned in the national numbering plan, or it is not 10 digits","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"What went wrong"}}},"example":{"message":"El número 9999999999 no existe."}}}}},"parameters":[{"name":"numero","in":"path","description":"10-digit Mexican phone number, area code included, digits only. Example: 4521158653","required":true,"schema":{"type":"string","example":"4521158653"}}]}},"/lada/{nir}":{"get":{"operationId":"get_lada_nir","summary":"Area code lookup","description":"Returns the states and municipalities served by a Mexican area code (lada, 2 or 3 digits) and how many numbering ranges it has assigned.","responses":{"200":{"description":"Area code found","content":{"application/json":{"schema":{"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"}}},"example":{"lada":"415","estados":["Guanajuato"],"municipios":[{"municipio":"San Miguel de Allende","estado":"Guanajuato"}],"series_asignadas":392}}}},"404":{"description":"The area code does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"What went wrong"}}},"example":{"message":"La lada 111 no existe."}}}}},"parameters":[{"name":"nir","in":"path","description":"Mexican area code (lada), 2 or 3 digits. Examples: 55, 415","required":true,"schema":{"type":"string","example":"415"}}]}},"/status":{"get":{"operationId":"get_status","summary":"Service status","description":"Service health and the size of the loaded data (numbering ranges, area codes and states).","responses":{"200":{"description":"Service is up","content":{"application/json":{"example":{"ok":true,"version":"2.1.0","fuente":"Plan Nacional de Numeración (IFT) + ABD de portabilidad","datos":{"rangos_numeracion":177934,"ladas":413,"estados":32}}}}},"503":{"description":"Service temporarily unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"What went wrong"}}},"example":{"message":"Servicio no disponible"}}}}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}