Introduction to Check This Phone API

Overview

The Check This Phone API is a powerful tool designed to validate, format, and standardize phone numbers from around the world. It helps developers ensure that phone numbers are stored correctly, cleanly, and consistently in their databases, preventing errors caused by incorrect or improperly formatted input.

With support for 232+ countries, the API uses an advanced phone number processing engine to accurately analyze phone numbers, detect their validity, and return them in a structured format.

Key Features

✔ Phone Number Validation – Check if a number is valid and correctly formatted.

✔ Automatic Formatting – Convert phone numbers into E.164, national, international, and RFC3966 formats.

✔ Country Detection – Identify the country associated with a phone number.

✔ Carrier Lookup – Retrieve carrier information when available.

✔ Error Handling – Get precise error messages for invalid or improperly formatted numbers.

✔ Bulk Verification – Process multiple phone numbers at once using batch requests.

✔ RESTful API – Easy-to-use and compatible with any programming language.

How It Works

1️⃣ Send a request with a phone number and optional country code.

2️⃣ Our system analyzes, verifies, and formats the number with precision.

3️⃣ Receive a structured response with validation status, formatted versions, and additional metadata.

Use Cases

🔹 CRM & Customer Databases – Ensure only valid phone numbers are stored.

🔹 E-commerce & Online Forms – Prevent users from entering incorrect numbers.

🔹 Marketing & Messaging Services – Validate numbers before sending SMS or calls.

🔹 Bulk Data Processing – Clean and standardize large datasets of phone numbers.

Next Steps

📌 Get Started Quickly – Check the Quick Start Guide.

📌 Learn How to Authenticate – See Authentication & API Keys.

📌 Explore API Endpoints – View the Core API Endpoints.

For further assistance, check out the Support & Contact section. 🚀

Authentication & API Keys

To access the Check This Phone API, authentication is required via an API token. This token ensures secure communication and identifies your requests.

Obtaining an API Token

1. Register for Free – Sign up on our platform to create an account.

2. Access the Dashboard – Log in and navigate to the API Token section.

3. Generate a New Token – Click the "Generate Token" button to create your unique API key.

Using the API Token

There are two ways to authenticate your requests using the API token:

1. For POST requests – Include the token in the Authorization header using the Bearer scheme:

    curl -X POST https://api.check-this-phone.com/phone/verify 
         -H "Authorization: Bearer YOUR_API_TOKEN" 
         -d "number=+123456789"
    

2. For GET requests – Append the token as a query parameter:

    curl -X GET "https://api.check-this-phone.com/phone/verify?number=+123456789&api_key=YOUR_API_TOKEN"
    

Keep your API token secure and do not share it. If compromised, you can revoke and generate a new one from your dashboard.

Quick Start Guide 🚀

Welcome to the Check This Phone API! Follow these steps to get started quickly and verify phone numbers with ease.

1. Subscribe for Free 🎉

Sign up and get an API key instantly.
Enjoy 100 free requests to test the service.

👉 Sign Up & Get Started

2. Make Your First Request 🔍

Use your API key to verify a phone number.

script.sh

    curl -X GET "https://api.check-this-phone.com/phone/verify?api_key=YOUR_API_KEY&number=+33612345678"
                

Example Response

response.json

    {
        "is_valid": true,
        "international_format": "+33 6 12 34 56 78",
        "national_format": "06 12 34 56 78",
        "E164_format": "+33612345678",
        "RFC3966_format": "tel:+33-6-12-34-56-78",
        "country_code": 33,
        "region_code": "FR",
        "type": "Mobile",
        "carrier": "SFR",
        "time_zones": [
            "Europe/Paris"
        ]
    }
                

3. Upgrade for More Requests 🚀

Need more than 100 requests? Upgrade to a paid plan for higher limits and priority access.

👉 💳 View Pricing & Upgrade

4. Integrate Easily 🛠

Use our detailed API reference for integration.
Compatible in PHP, JavaScript, Python, and more.
Support for batch batch verification via CSV.

5. Start Building Now! 🚀

You're all set! Start verifying phone numbers and enhance your applications with accurate phone data.

💡 Need help? Contact our support team anytime by clicking here.

Supported Countries

Overview

Our API provides an endpoint to fetch a list of supported countries. Additionally, a search input allows users to check whether a specific country is included.

Coverage

- Supports 243 countries , ensuring global availability.

- Covers more than 240 regions , including various dialing codes.

- Regularly updated to maintain accuracy.

How to Access the List?

API Endpoint: Retrieve the full list of supported countries.

    curl -X GET "https://api.check-this-phone.com/phone/countries?api_key=YOUR_API_KEY" -H "Accept: application/json"

Dropdown Input: Easily check for a country using the selection field below.

Core API Endpoints

1. Verify a Phone Number (GET)

URL

GET /phone/verify

Allows users to validate and format a phone number using query parameters.

2. Verify a Phone Number (POST)

URL

POST /phone/verify

Accepts a JSON payload to validate and format a phone number.

3. Extract Phone Numbers from Text

URL

POST /phone/extract-from-text

Extracts phone numbers from a given text input.

4. Get Supported Countries

URL

GET /phone/countries

Returns a list of supported countries for phone validation.

Validating a phone number

This section provides information on the API endpoints related to phone number validation. The API supports verifying single phone numbers, extracting phone numbers from text, and retrieving the list of supported countries for phone number validation.

1. Phone Validating

a. Validating a Single Phone (GET)

Description: This endpoint allows you to validate a single phone number using a GET request.

To pass the locale only if the phone's country code is not present, you can check if the phone number has a country code (i.e., it includes the international dialing code). If the country code is missing, then you can append the locale to the query parameters.

The locale parameter can be used in any situation, but it significantly increases precision when checking.

The locale parameter follows the ISO 3166-1 alpha-2 country code standard for region identification.

Request:

Method: GET

text

https://api.check-this-phone.com/phone/verify?number=PHONE_NUMBER&locale=LOCALE

    curl --location 'https://api.check-this-phone.com/phone/verify?api_key=__API_KEY__&number=+33987654321&locale=fr'
    

Query Parameters:

api_key: Your API key.

number: The phone number you want to validate (e.g., +33 9 87 65 43 21)..

locale: The locale for the phone number validation (e.g., fr for French).

Response:

response.json

    {
        "status": "success",
        "phone": {
            "is_valid": true,
            "international_format": "+33 9 87 65 43 21",
            "national_format": "09 87 65 43 21",
            "E164_format": "+33987654321",
            "RFC3966_format": "tel:+33-9-87-65-43-21",
            "country_code": 33,
            "region_code": "FR",
            "type": "VoIP",
            "carrier": "Unknown",
            "time_zones": [
                "Europe/Paris"
            ]
        }
    }
    

This endpoint will return the validation result for the provided phone number. The response structure will vary depending on the validation outcome.

b. Validating a Single Phone (POST)

Description: This endpoint validates a single phone number using a POST request. You can include the phone number and locale in the body of the request.

Request:

Method: POST

URL:

URL

https://api.check-this-phone.com/phone/verify

Authorization: Bearer token authentication using the API key.

Request Body:

request.json

    {
        "locale": "fr",
        "number": "+33 9 87 65 43 21"
    }
    

Examples of request:

    curl --location 'https://api.check-this-phone.com/phone/verify' 
         --header 'Content-Type: application/json' 
         --header 'Authorization: Bearer __YOUR_API_KEY__' 
         --data '{
            "locale" : "fr",
            "number" : "+33 9 87 65 43 21"
        }' 
    

Response:

The response will contain the validation result for the phone number provided in the request body.

response.json

    {
        "status": "success",
        "phone": {
            "is_valid": true,
            "international_format": "+33 9 87 65 43 21",
            "national_format": "09 87 65 43 21",
            "E164_format": "+33987654321",
            "RFC3966_format": "tel:+33-9-87-65-43-21",
            "country_code": 33,
            "region_code": "FR",
            "type": "VoIP",
            "carrier": "Unknown",
            "time_zones": [
                "Europe/Paris"
            ]
        }
    }
    

c. Extracting Phones from Text (POST)

Description: : This endpoint allows you to extract phone numbers from a given text content. It uses a POST request with the text in the body, and it will return any detected phone numbers.

Request:

Method: POST

URL

https://api.check-this-phone.com/phone/extract-from-text

Authorization: Bearer token authentication using the API key.

Request Body:

request.json

    {
        "locale": "fr",
        "content": "If you're planning to contact us, here are some important numbers:
        n- Our customer service number: +33 1 23 45 67 89
        n- Technical support: +33 6 12 34 56 78
        n- For emergencies: +33 9 87 65 43 21
        nFeel free to reach out during business hours!"
    }
                

Examples of request:

   curl --location 'https://api.check-this-phone.com/phone/extract-from-text' 
        --header 'Content-Type: application/json' 
        --header 'Authorization: Bearer __YOUR_API_KEY__' 
        --data '{
                "locale": "fr",
                "content": "If you re planning to contact us, here are some important numbers:
                 Our customer service number: +33 1 23 45 67 89  
                 Technical support: +33 6 12 34 56 78
                  For emergencies: +33 9 87 65 43 21
                  Feel free to reach out during business hours!"
                }
'
    

Response:

response.json

    {
        "status": "success",
        "phone": [
            {
                "phone_number": "+33123456789",
                "locale": "FR",
                "is_valid": "Valid",
                "E164_format": "+33123456789",
                "RFC3966_format": "tel:+33-1-23-45-67-89",
                "carrier": "Unknown",
                "country_code": 33,
                "international_format": "+33 1 23 45 67 89",
                "national_format": "01 23 45 67 89",
                "region_code": "FR",
                "time_zones": "Europe/Paris",
                "type": "Fixed Line"
            },
            {
                "phone_number": "+33612345678",
                "locale": "FR",
                "is_valid": "Valid",
                "E164_format": "+33612345678",
                "RFC3966_format": "tel:+33-6-12-34-56-78",
                "carrier": "SFR",
                "country_code": 33,
                "international_format": "+33 6 12 34 56 78",
                "national_format": "06 12 34 56 78",
                "region_code": "FR",
                "time_zones": "Europe/Paris",
                "type": "Mobile"
            },
            {
                "phone_number": "+33987654321",
                "locale": "FR",
                "is_valid": "Valid",
                "E164_format": "+33987654321",
                "RFC3966_format": "tel:+33-9-87-65-43-21",
                "carrier": "Unknown",
                "country_code": 33,
                "international_format": "+33 9 87 65 43 21",
                "national_format": "09 87 65 43 21",
                "region_code": "FR",
                "time_zones": "Europe/Paris",
                "type": "VoIP"
            }
        ]
    }
            

The response will contain an array of phone numbers detected in the provided text.

2. Supported Countries

a. Retrieving Supported Countries (GET)

Description: This endpoint retrieves a list of supported countries for phone number validation. It returns details about the countries, including their name, country code, and phone code.

Request:

Method: GET

URL

https://api.check-this-phone.com/phone/countries?api_key=__YOUR_API_KEY__

Query Parameters:

api_key: Your API key.

Response:

The response will include a list of countries with their details. Below is an example of the structure of the response:

response.json

    {
        "total": 243,
        "countries": [
            {
                "id": 2,
                "name": "Grenada",
                "alpha2": "GD",
                "phone_code": "+1473"
            },
            {
                "id": 3,
                "name": "France",
                "alpha2": "FR",
                "phone_code": "+33"
            }
        ]
    }
    

Response object

This section provides detailed information about the fields in the phone number validation response.

When you validate a phone number, the system returns a comprehensive set of data that helps you understand various aspects of the number's validity, format, and related information.

Below, you will find a table that describes each field in the response, helping you interpret the information correctly.

Details about each phone field.
Field	Description
is_valid	Boolean: Indicates whether the phone number is valid according to the formatting rules and number type checks.
international_format	String: The phone number formatted in the international format (e.g., +33 9 87 65 43 21). It includes the country code and the national number.
national_format	String: The phone number formatted in the national format (e.g., 09 87 65 43 21 for France), specific to the country without the international country code.
E164_format	String: The phone number in the E.164 format (e.g., +33987654321), which includes the country code without any spaces, hyphens, or parentheses.
RFC3966_format	String: The phone number formatted according to RFC3966 (e.g., tel:+33-9-87-65-43-21). This format is commonly used in web and URI-based applications.
country_code	Integer: The country calling code for the phone number (e.g., 33 for France), which is used to dial into the country from abroad.
region_code	String: The region code (ISO 3166-1 alpha-2 country code) for the phone number's country (e.g., FR for France).
type	String: The type of phone number (e.g., 'Mobile', 'Fixed Line', 'Toll-Free', etc.), based on the phone number's classification.
carrier	String: The name of the carrier or service provider for the phone number (e.g., 'Verizon') or 'Unknown' if no carrier is detected.
time_zones	Array: A list of time zones (e.g., ['Europe/Paris', 'America/New_York']) associated with the region or country of the phone number.

Rate Limits & Additional Requests

Our API enforces rate limits based on the plan you subscribe to. Each plan comes with a predefined number of requests, and once this limit is reached, additional requests will not be processed unless an extra package is purchased.

Purchasing Additional Requests

Customers can purchase additional request packages directly via the dashboard. These extra packages are available in three tiers:

1000 extra requests

5000 extra requests

10000 extra requests

Pricing details for these packages are only available within the dashboard.

Usage Notifications

To help customers manage their request limits effectively, we send an email notification when 70% of the total request quota has been used.

This ensures that you have enough time to take necessary actions before reaching your limit.

Grace Period for Premium Plans

For all paid plans, except the Basic Plan, we provide a tolerance of 100 additional requests after the limit is reached. This prevents an immediate service interruption and allows for a smooth transition while additional requests are arranged.

Customer Support & Custom Solutions

Our team is committed to providing uninterrupted service and is open to discussing alternative solutions if needed. If you require a custom request limit adjustment, feel free to contact us via the support section in your dashboard.

Error Codes and Descriptions

This section outlines the possible error codes returned by the API, along with their meanings and potential solutions.

List of possible error codes and their meanings.
Error Code	Description	Explanation & Resolution
1001	API key is missing.	The request must include an API key in the parameters. Ensure that the `api_key` field is provided.
1002	Invalid credentials (API key not found).	The API key provided does not match any valid credentials. Verify that the correct API key is being used.
1003	Request limit exceeded.	The user has reached the maximum number of allowed API requests. Consider upgrading the plan or checking the request quota.
1004	Error fetching request statistics.	There was an issue retrieving usage statistics for the account. Try again later or contact support if the problem persists.
1005	Invalid token.	The provided token is not valid or has been revoked. Ensure that the token is correctly generated and active.
1006	Phone number is missing or invalid.	The request does not contain a valid phone number. Ensure that the `number` field is included and formatted correctly.
1007	Invalid JSON format.	The request body contains improperly formatted JSON. Ensure that the JSON structure is valid and correctly encoded.
1008	Text content is missing.	The request must include a "text" field, but it was either missing or empty. Make sure the text parameter is properly provided.

Support & Assistance

We are committed to providing reliable support for all our customers to ensure a seamless experience with our API.

How to Get Support

Support is available through the following channels:

Dashboard: All customers can access the support section in the dashboard to submit requests.

Email: You can reach our support team at contact@check-this-phone.com.

Support Eligibility

All paid plans full support.

The free plan does not include support. free plan does not include support.

If you require assistance, please activate a support request via the dashboard in the Support section.

Our team will be happy to assist you!

📌 Integrating Phone Verification API with Zapier

Overview

Zapier allows you to automate workflows by integrating different applications. You can use Zapier Webhooks to connect the Phone Verification API to other apps like Google Sheets, Slack, or Email.

🔗 Steps to Integrate

1. Create a Zap

Log in to Zapier.
Click "Create Zap". Create Zap.
Select "Webhook by Zapier" as the Trigger.

2. Choose Trigger Event

Select Retrieve Poll (for scheduled checks) or "Custom Webhook " (for real-time requests).

3. Set Up Webhook URL

Choose GET as the request method.
Use the following Webhook URL (replace ( with your actual API key __API_KEY__ with your actual API key):
Select " Webhook by Zapier" as the Trigger.
URL
1https://api.check-this-phone.com/phone/verify?api_key=__API_KEY__&number=+33987654321&locale=fr
If needed, make the number and locale dynamic using previous Zap steps.

4. Test the Webhook

Click "Test Trigger" to verify that the API request returns the correct response.

5. Use the API Response in Another Action

Choose an action step, such as:

Save results to Google Sheets
Send a Slack notification
Trigger an email alert

6. Activate Your Zap! 🚀

Click "Publish" and start automating.

📌 Example: Using a Zapier Code Step (JavaScript)

If you need additional flexibility, you can use the "public.pages.documentation.zapier_integration.content.27.1" public.pages.documentation.zapier_integration.content.27.2

request.js

    fetch("https://api.check-this-phone.com/phone/verify?api_key=__API_KEY__&number=+33987654321&locale=fr")
        .then(response => response.json())
        .then(data => console.log(data));
                    

This script fetches phone validation data and can be used in custom Zapier automations.

API Documentation Sections

API Overview

Introduction to Check This Phone API

Overview

Authentication

Quick Start Guide 🚀

Supported Countries

public.pages.documentation.core_endpoints.h2

Validating Phone

Rate Limits

Error Handling

Support

Zapier Integration