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 with country code.

πŸ‘

Test data

Number: 2348060000000

πŸ“˜

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
number2349060000000User'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": {}
}