Validate Phone Number

Mobile_API »Validate Dial Number

Base URL

https://apimobile.callproof.com

Endpoint

/api/validate-dial-number/{phone_number}

Purpose

Validates a phone number for dialing. If the number already exists for the user’s company, returns the matching contact/phone details. If it does not exist, creates an “unknown” contact for that number and returns the new contact/phone details, including recent notes and image when available.

HTTP Method

GET

Headers

Header	Required	Description
Authorization	Yes	Bearer access token

Security

• Yes – Requires Bearer Token authentication.

Parameters

Path Parameters

Parameter	Type	Required	Description
phone_number	string	Yes	Phone number to validate for dialing

Query Parameters

None.

Request Body

None.

Successful Response (200)

Returns contact and phone details for the validated number.

Field	Type	Description
clientStatusCode	integer	Status indicator for the client (for example, 200)
user_id	integer	Identifier of the authenticated user
company_id	integer	Identifier of the authenticated user’s company
data	object	Dial validation payload
uri	string	Requested resource URI

data

Field	Type	Description
contact_phone_id	integer	Unique identifier of the contact phone record
contact_id	integer	Unique identifier of the contact
contact_person_name	string	Name of the linked person, when available
phone_type_id	integer	Phone type identifier
phone_number	string	Validated phone number
company_id	integer	Company identifier
company_name	string	Company name
contact_company_name	string	Contact company name
ext	string	Phone extension, when available
country_code	string	Dialing/country code
country_iso_code	string	Country ISO code
contact_type_id	integer	Contact type identifier
contact_type_name	string	Contact type name
unknown	boolean	Whether the contact/phone is marked as unknown
image	string	Contact/person image path or URL, when available
notes	string	Latest notes for the contact/number, when available

Error Responses

Status Code	Meaning
400	Bad Request – the dial number could not be validated
401	Unauthorized – missing, invalid, or expired Bearer token

• 400 – Phone/contact details could not be resolved (for example, "Contact Phone Id is Invalid"), or another processing error.
• 401 – Authentication failed or the access token is missing/expired.