Phone Risk

Description

A solution to obtain a phone number validation through MTC (Ministerio de Transportes y Comunicaciones). The MTC is responsible for managing and regulating the allocation and use of numbering resources in the country. Although the Supervisory Agency for Private Investment in Telecommunications (OSIPTEL) oversees telecommunications services and ensures compliance with regulations, the MTC is the entity that officially administers the Fundamental Technical Numbering Plan.

MSLA ID complements this API with our consumer dataset to add ownership information based on the official ID number and/or names.

HTTP method GET

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	bearer jwt token

URI request parameter

NAME	REQUIRED	TYPE	DESCRIPTION	EXAMPLE
Phone number	✅	string	Phone number for land lines or mobiles	(1) 4365411 or 917856331
DNI	Optional	string	Official ID number	09374521
Father surname	Optional	string	-	SARAVIA
Mother surname	Optional	string	-	CASTILLA
Name 1	Optional	string	-	ANA
Name 2	Optional	string	-	BERTHA

Status code responses

Code	Description
200	OK
400	Bad request
401	Unauthorized
404	Not found
500	Internal server error.

The full documentation error codes can be found here.

Response 200 status code

{
    "TELCOdata": {
        "area code": "null",
        "serie": "90000",
        "telco provider": "VIETTEL PERU S.A.C.",
        "phone type": "MOVIL",
        "status": "VALIDO"
    },
    "Ownership data": {
        "surname": "JUAN",
        "secondSurname": "ALBERTO",
        "firstName": "LOPEZ",
        "middleName": "ROSALES",
        "dateofbirth": "05/11/1981",
        "Inscriptiondate": "07/08/1999",
        "Issuedate": "10/10/1999",
        "dateofexpiry": "11/12/2008",
        "nationallocationcode": "140903",
        "nationaladdresscode": "LIMA-LIMA-SURQUILLO",
        "Address": "JAVIER FERNANDEZ 110",
        "sex": "M"
    }
}