Twilio Unread Messages/Unread Missed Call Count

From docs
Revision as of 07:28, 21 July 2026 by Ashley DeBon (talk | contribs) (Created page with "== Get Unread Call And Message Count == === Base URL === https://apimobile.callproof.com === Endpoint === /api/unread-call-message-count === Purpose === Returns unread inbo...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Get Unread Call And Message Count

Base URL

https://apimobile.callproof.com

Endpoint

/api/unread-call-message-count

Purpose

Returns unread inbound SMS count for the authenticated user’s company and unread/missed call count for the authenticated user.

HTTP Method

GET

Headers

Header Required Description
Authorization Yes Bearer access token

Security

  • Yes – Requires Bearer Token authentication.

Parameters

Path Parameters

None.

Query Parameters

None.

Request Body

None.

Successful Response (200)

Returns unread message and missed-call counts.

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

data

Field Type Description
twilio_sms_count integer Number of unread inbound SMS messages for the company (messages not marked as seen)
twilio_call_count integer Sum of unread/missed call counts for the authenticated user (calls not yet viewed)

Error Responses

Status Code Meaning
400 Bad Request – counts could not be retrieved
401 Unauthorized – missing, invalid, or expired Bearer token
  • 400 – An error occurred while retrieving unread message/call counts.
  • 401 – Authentication failed or the access token is missing/expired.