Get the List of Voicemail Details - Revision history

Ashley DeBon: /* Successful Response (200) */

2026-07-21T06:32:26Z

‎Successful Response (200)

Ashley DeBon: /* Get Voicemail List */

2026-07-21T06:30:43Z

‎Get Voicemail List

Ashley DeBon at 06:28, 21 July 2026

2026-07-21T06:28:54Z

Ashley DeBon: /* Successful Response (200) */

2026-07-21T06:18:16Z

‎Successful Response (200)

Ashley DeBon: /* Get Recorded Voicemail Details */

2026-07-21T06:16:56Z

‎Get Recorded Voicemail Details

Ashley DeBon: Created page with "== Get Recorded Voicemail Details == === Base URL === https://apimobile.callproof.com === Endpoint === /api/voicemail/recorded/{phone_number} === Purpose === Retrieves the..."

2026-07-21T06:16:40Z

Created page with "== Get Recorded Voicemail Details == === Base URL === https://apimobile.callproof.com === Endpoint === /api/voicemail/recorded/{phone_number} === Purpose === Retrieves the..."

New page

== Get Recorded Voicemail Details ==

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

=== Endpoint ===
/api/voicemail/recorded/{phone_number}

=== Purpose ===
Retrieves the recorded greeting/voicemail file details for a company Twilio phone number. Returns the recording identifier and a media URL when a voicemail recording is available for that number.

=== 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
|-
| phone_number || string || Yes || Twilio phone number whose recorded voicemail details should be retrieved
|}

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

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

=== Successful Response (200) ===
Returns recorded voicemail details for the phone number. If no matching number/recording is found, <code>data</code> may be an empty array.

{| 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 || array || Recorded voicemail details (see below)
|-
| uri || string || Requested resource URI
|}

==== data[] ====
{| class="wikitable"
! Field !! Type !! Description
|-
| id || integer || Unique identifier of the Twilio phone number record
|-
| url || string || Full media URL of the recorded voicemail file
|}

=== Error Responses ===
{| class="wikitable"
! Status Code !! Meaning
|-
| 400 || Bad Request – recorded voicemail details could not be retrieved
|-
| 401 || Unauthorized – missing, invalid, or expired Bearer token
|}

* '''400''' – An error occurred while retrieving recorded voicemail details (for example, "Error while retrieving the recorded voicemail messages list").
* '''401''' – Authentication failed or the access token is missing/expired.

← Older revision		Revision as of 06:30, 21 July 2026
Line 1:		Line 1:
−	== Get Voicemail List ==	+	== [[Mobile_API]] »Get Voicemail List ==

	=== Base URL ===		=== Base URL ===

← Older revision		Revision as of 06:16, 21 July 2026
Line 1:		Line 1:
−	== Get Recorded Voicemail Details ==	+	== [[Mobile_API]] »Get Recorded Voicemail Details ==

	=== Base URL ===		=== Base URL ===

@@ Line 37: / Line 37: @@
 ==== Request Body ====
 None.
 === Successful Response (200) ===

@@ Line 1: / Line 1: @@
-== [[Mobile_API]] &#187;Get Recorded Voicemail Details ==
+== Get Voicemail List ==
 === Base URL ===
@@ Line 5: / Line 5: @@
 === Endpoint ===
-/api/voicemail/recorded/{phone_number}
+/api/voicemail/list
 === Purpose ===
-Retrieves the recorded greeting/voicemail file details for a company Twilio phone number. Returns the recording identifier and a media URL when a voicemail recording is available for that number.
+Retrieves a paginated list of recorded voicemails for the authenticated user’s company. Only calls marked as voicemail with a contact, phone, and recording are returned, newest first.
 === HTTP Method ===
@@ Line 26: / Line 26: @@
 ==== Path Parameters ====
 {| class="wikitable"
 ! Parameter !! Type !! Required !! Description
 |-
-| phone_number || string || Yes || Twilio phone number whose recorded voicemail details should be retrieved
+| page || integer || No || Page number for pagination (default: 1). Page size is 10
 |}
 ==== Request Body ====
 None.
 === Successful Response (200) ===
-Returns recorded voicemail details for the phone number. If no matching number/recording is found, <code>data</code> may be an empty array.
+Returns a paginated list of voicemail recordings.
 {| class="wikitable"
@@ Line 58: / Line 50: @@
 | company_id || integer || Identifier of the authenticated user’s company
 |-
-| data || array || Recorded voicemail details (see below)
+| data || array || List of voicemail records (see below)
 |-
 | uri || string || Requested resource URI
@@ Line 67: / Line 87: @@
 ! Field !! Type !! Description
 |-
-| id || integer || Unique identifier of the Twilio phone number record
+| id || integer || Unique identifier of the voicemail/call record
 |-
-| url || string || Full media URL of the recorded voicemail file
+| image || string || Contact/person image URL, when available
 |}
@@ Line 76: / Line 114: @@
 ! Status Code !! Meaning
 |-
-| 400 || Bad Request – recorded voicemail details could not be retrieved
+| 400 || Bad Request – voicemail list could not be retrieved
 |-
 | 401 || Unauthorized – missing, invalid, or expired Bearer token
 |}
-* '''400''' – An error occurred while retrieving recorded voicemail details (for example, "Error while retrieving  the recorded voicemail messages list").
+* '''400''' – An error occurred while retrieving voicemails (for example, "Error while retrieving  the recorded voicemail messages list").
 * '''401''' – Authentication failed or the access token is missing/expired.