Phone Number Advance

Global phone status check

With our phone number status check endpoint you can now verify the status of any phone number, country code, zip, whether the line has been blocked or not, the service provider for the number and phone type.

To use this endpoint enter a valid phone number with country code.

👍

Test data

Number: 254715100090

📘

Post:

https://api.prembly.com/identitypass/verification/global/phone-status-check

Request Header

keyvaluedescription
app-idapp-idyour app-id
x-api-keyx-api-keyyour api-key

Request Body

keyvaluedescription
number254715100090User's phone number

Sample Response

{
    "status": true,
    "detail": "Verification Successful",
    "response_code": "00",
    "data": {
        "location": {
            "city": "Countrywide",
            "state": null,
            "zip": null,
            "metro_code": null,
            "county": null,
            "country": {
                "name": "Kenya",
                "iso2": "KE",
                "iso3": "KEN"
            },
            "coordinates": {
                "latitude": null,
                "longitude": null
            },
            "time_zone": {
                "name": null,
                "utc_offset_max": "+3",
                "utc_offset_min": "+3"
            }
        },
        "blocklisting": {
            "blocked": false,
            "block_code": 0,
            "block_description": "Not blocked"
        },
        "numbering": {
            "cleansing": {
                "call": {
                    "country_code": "254",
                    "phone_number": "715100090",
                    "cleansed_code": 100,
                    "min_length": 10,
                    "max_length": 10
                },
                "sms": {
                    "country_code": "254",
                    "phone_number": "715100090",
                    "cleansed_code": 100,
                    "min_length": 10,
                    "max_length": 10
                }
            },
            "original": {
                "complete_phone_number": "254715100090",
                "country_code": "254",
                "phone_number": "715100090"
            }
        },
        "phone_type": {
            "code": "2",
            "description": "MOBILE"
        },
        "carrier": {
            "name": "NULL"
        },
        "contact": {
            "status": {
                "code": 2000,
                "description": "Request successfully completed"
            },
            "first_name": "aajay",
            "last_name": "IL",
            "address1": "",
            "address2": "",
            "address3": "",
            "address4": "",
            "city": "naaa",
            "state_province": "oou",
            "country": "KE",
            "zip_postal_code": "",
            "email_address": "",
            "date_of_birth": null
        }
    },
    "verification": {
        "status": "VERIFIED",
        "reference": "0431e300-3b16-411e-b94b-79519301afbf"
    },
    "widget_info": {},
    "session": {}
}