Phone Status Check

global phone status check

Coverage: Kenya, Portugal, UK, USA, India, Brazil, Cyprus, Germany, Netherlands, Switzerland, Malta

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

phone number: 2548060000000

📘

Post

https://api.peleza.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
number2548060000000user's 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": {}
}