View source for Retrieve the Specific Contact Phone Based on ContactId

== Get Specific Contact Phone ==

=== Base URL ===
https://apimobile.callproof.com

=== Endpoint ===
/api/contacts/{id}/phone/{phone_id}

=== Purpose ===
Retrieves a single phone number for a contact, including phone type, formatted number, country code, extension, and any people (personnel) linked to that phone.

=== HTTP Method ===
GET

=== Headers ===
{| class="wikitable"
! Header !! Required !! Description
|-
| Authorization || Yes || Bearer access token
|}

=== Security ===
* '''Yes''' – Requires Bearer Token authentication.

=== Parameters ===

==== Path Parameters ====
{| class="wikitable"
! Parameter !! Type !! Required !! Description
|-
| id || integer || Yes || Unique identifier of the contact
|-
| phone_id || integer || Yes || Unique identifier of the phone number to retrieve
|}

==== Query Parameters ====
None.

==== Request Body ====
None.

=== cURL Example for Android ===
<pre>
curl --location 'https://apimobile.callproof.com/api/contacts/{id}/phone/{phone_id}' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
</pre>
=== cURL Example for iOS ===
<pre>
curl --location 'https://apimobile.callproof.com/api/contacts/{id}/phone/{phone_id}' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
</pre>

=== Successful Response (200) ===
Returns the phone details for the given contact and phone ID.

{| class="wikitable"
! 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 || Phone detail payload (see below)
|-
| uri || string || Requested resource URI
|}

==== data.contact_phone_Detail ====
{| class="wikitable"
! Field !! Type !! Description
|-
| contact_name || string || Company / contact name associated with the phone
|-
| phone_id || integer || Unique identifier of the phone record
|-
| phone_type_id || integer || Phone type identifier
|-
| phone_type_name || string || Phone type display name (for example, Cell, Work)
|-
| phone_number || string || Formatted phone number
|-
| phone_extension || string || Main extension for the phone number
|-
| phone_country_code || string || Country / dialing code for the phone number
|-
| contact_personnel || array || List of people linked to this phone (see below)
|}

==== data.contact_phone_Detail.contact_personnel[] ====
{| class="wikitable"
! Field !! Type !! Description
|-
| personnel_id || integer || Unique identifier of the linked person
|-
| personnel_name || string || Full name of the linked person
|-
| extension || string || Extension for that person on this phone (included when available)
|}

=== Error Responses ===
{| class="wikitable"
! Status Code !! Meaning
|-
| 400 || Bad Request – the phone could not be retrieved (for example, invalid contact/phone combination)
|-
| 401 || Unauthorized – missing, invalid, or expired Bearer token
|}

* '''400''' – The requested phone could not be loaded for the given contact.
* '''401''' – Authentication failed or the access token is missing/expired.