Phone Number Status Check

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 to be checked.

πŸ‘

Test data

Number: 08060000000

πŸ“˜

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
number9060000000User'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": "Nigeria",
                "iso2": "NG",
                "iso3": "NGA"
            },
            "coordinates": {
                "latitude": null,
                "longitude": null
            },
            "time_zone": {
                "name": null,
                "utc_offset_max": "+1",
                "utc_offset_min": "+1"
            }
        },
        "blocklisting": {
            "blocked": false,
            "block_code": 0,
            "block_description": "Not blocked"
        },
        "numbering": {
            "cleansing": {
                "call": {
                    "country_code": "234",
                    "phone_number": "8130000000",
                    "cleansed_code": 100,
                    "min_length": 10,
                    "max_length": 10
                },
                "sms": {
                    "country_code": "234",
                    "phone_number": "813000000000",
                    "cleansed_code": 100,
                    "min_length": 10,
                    "max_length": 10
                }
            },
            "original": {
                "complete_phone_number": "234813000000",
                "country_code": "234",
                "phone_number": "8130000000"
            }
        },
        "phone_type": {
            "code": "2",
            "description": "MOBILE"
        },
        "carrier": {
            "name": "MTN Nigeria"
        },
        "contact": {
            "status": {
                "code": 2000,
                "description": "Request successfully completed"
            },
            "first_name": "aajay",
            "last_name": "IL",
            "address1": "",
            "address2": "",
            "address3": "",
            "address4": "",
            "city": "naaa",
            "state_province": "oou",
            "country": "NG",
            "zip_postal_code": "",
            "email_address": "",
            "date_of_birth": null
        }
    },
    "verification": {
        "status": "VERIFIED",
        "reference": "0431e300-3b16-411e-b94b-79519301afbf"
    },
    "widget_info": {},
    "session": {}
}