Phone Name Attributes

The Phone Name Attribute API is a service that provides detailed attributes and metadata associated with a given phone number or name. This API offers valuable insights into the characteristics and properties of phone numbers or names, facilitating various use cases such as identity verification, data analysis, and information retrieval. By querying the API with a phone number or name, users can retrieve a comprehensive set of attributes that describe the phone number or name in detail.

Submit Document

phone_name_attributes

POST https://secctrl.tutelar.io/api/v1/kyc/utility/phone_name_attributes

Post parameters description is given below,

Post Parameter	Type	Is Mandatory	Description
name	String	Yes	Full Name
first_name	String	Yes	First Name
last_name	String	Yes	Last name
phone_number	Number	Yes	Phone Number

Sample Post Parameters

{
    "name": "Karthikeyan N",
    "first_name": "Karthikeyan",
    "last_name": "N",
    "phone_number": "918190099470"
}

200: Success Response

{
    "success": true,
    "code": 200,
    "status": "completed",
    "reference_id": "20d7068e-5f88-4531-8bd7-402d6505a500",
    "result": {
        "businessNameDetected": false,
        "digitalage": -1,
        "firstNameMatch": false,
        "lastNameMatch": false,
        "trasactionId": "UP21cFfehcwEZ1g=",
        "nameMatchScore": -1
    },
    "requested_at": "2024-03-07T07:23:01.482Z",
    "completed_at": "2024-03-07T07:23:10.545Z"
}

400: Validation Error Response

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Invalid phone number",
        "field": "phone_number",
        "code": "BAD_REQUEST"
    }
}

200: Failure Response

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "ecd78066-c7e9-4c9b-ba97-8eb18ed32947",
    "status": "failed",
    "error": {
        "message": "Validation Failed",
        "code": "ERROR"
    },
    "requested_at": "2024-03-14T05:21:05.793Z",
    "completed_at": "2024-03-14T05:21:07.640Z"
}