Get a Mobile Call Log

Retrieves the details of a mobile call log.

Request URL

GET {base_url}/uc-creport/api/v1/mobile/call-logs/{id}

Request parameters

Headers
Parameter Required Type Description
Authorization Yes String The access token used for authentication.

Format: Bearer {access_token}.

x-tenant-code Yes String The tenant name.
Note: You can obtain tenant name using the Query Tenants interface.
Path parameters
Parameter Required Type Description
id Yes String The ID of the call log to query. You can obtain the ID using the Query Mobile Call Logs interface.

Response parameters

Parameter Type Description
requestId String The unique ID of the request, which can be used to quickly locate the request.
code String The HTTP status code of the request.
  • 200: Request succeeded.
  • Non-200 value: Request failed.
message String The status message of the request.
detailMessage String The detailed error information.

When the request is successful, this parameter returns empty.

result Object<Mobile_Call_Log_Detail_Result> The result of the request.
Mobile_Call_Log_Detail_Result
Parameter Type Description
detail Object<Mobile_Call_Log_Detail> The details of the mobile call log.
Mobile_Call_Log_Detail
Parameter Type Description
id String The ID of the call log.
uid String The unique ID of the call.
timestamp String The start time of the call, in Unix timestamp format (microseconds).
callType String

The call type from the system perspective:

  • inbound: An inbound call.
  • outbound: An outbound call.
  • internal: An internal call.
callStatus String The call status.
name String The display name of the other party.
number String The number of the other party.
numberType String

The type of the other party's number:

  • extension: An extension.
  • extension_mobile: An extension user with a bound mobile number.
  • external: An external number.
  • personal_contact: A personal contact.
  • company_contact: A company contact.
companyName String The company name of the other party. This parameter is returned only for contacts.
avatar String The avatar URL of the other party. This parameter is returned only for extensions.
presence String The presence status of the other party. This parameter is returned only for extensions.
sourceFeature String

The feature that the call came from:

  • queue: A queue.
  • ring_group: A ring group.

An empty string indicates that the call did not come from a queue or ring group.

sourceNumber String The number of the source feature.
sourceName String The display name of the source feature.
processStatus Integer

The process status of the call log:

  • 0: Not applicable.
  • 1: Pending.
  • 2: Processing.
  • 3: Processed.
processBy String The number of the user who processed the call log.
processByName String The name of the user who processed the call log.
processAt String The time when the call log was processed, in Unix timestamp format (microseconds).
answeredByNumber String The extension number of the agent who answered the call. This parameter is returned only for answered calls on the Queue tab.
answeredByName String The name of the agent who answered the call. This parameter is returned only for answered calls on the Queue tab.
totalDuration Integer The talk duration of the call (talk time plus hold time), in seconds.
category String

The call category from the extension user's perspective:

  • incoming: The user received the call.
  • missed: The user missed the call.
  • outgoing: The user made the call.
phoneLabel String

The label of the other party's number. This parameter is returned only for contacts.

  • extension
  • mobile_phone
  • business_phone
  • home_phone
  • business_fax
  • home_fax
  • mobile2_phone
  • business2_phone
  • home2_phone
  • other_phone
online Boolean

Whether the other party is online.

  • true: The other party is online or has a registered phone.
  • false: The other party is offline.

This parameter is returned only for extensions.

extensionNumber String The extension number that the mobile number is bound to. This parameter is returned only when numberType is extension_mobile.