Phone Number 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

Request Body

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