Get Places Additional Details

Mobile_API »Get Place Phone Details

Base URL

https://apimobile.callproof.com

Endpoint

/api/place-details/{contact_id}

Purpose

Retrieves Google Place phone (and website) details for a contact that is linked to a place record. If a phone number is found, it is normalized, saved to the place/contact, set as the contact’s default phone when applicable, and returned to the client.

HTTP Method

GET

Headers

Header	Required	Description
Authorization	Yes	Bearer access token
Version-Number	No	App version used when deciding whether to call Google Places details for phone/website (used when version is 5.072 or higher)

Security

• Yes – Requires Bearer Token authentication.

Parameters

Path Parameters

Parameter	Type	Required	Description
contact_id	integer	Yes	Unique identifier of the contact linked to a Google Place

Query Parameters

None.

Request Body

None.

Successful Response (200)

Returns the retrieved/saved place phone details.

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	Place phone payload
uri	string	Requested resource URI

data

Field	Type	Description
phone_id	integer	Identifier of the contact phone record that was created or updated
phone_number	string	Normalized phone number retrieved for the place

Error Responses

Status Code	Meaning
400	Bad Request – place phone details could not be retrieved or saved
401	Unauthorized – missing, invalid, or expired Bearer token

• 400 – No matching place/contact records ("No Records Found"), no phone number found ("No Phone Number Found"), or another retrieval/save error (for example, "Error while retrieving place phone details").
• 401 – Authentication failed or the access token is missing/expired.