# List Call Log

`ringcentral_list-call-log` · RingCentral MCP tool · Voice

List RingCentral call log records for the company, or for a single extension when extensionId is supplied, optionally filtered by date range, direction, type, and recording presence.

## RingCentral Frequently Asked Questions

**What does the List Call Log tool do?**

This page documents the List Call Log tool (`ringcentral_list-call-log`). List RingCentral call log records for the company, or for a single extension when extensionId is supplied, optionally filtered by date range, direction, type, and recording presence. It is one of the RingCentral Voice tools, invoked through your firm's Weave MCP connection and available to members whose access level permits it.

**What is the RingCentral integration?**

The RingCentral integration connects your firm's RingCentral account to Weave. RingCentral (RingEX) is a cloud phone/UCaaS platform. This integration exposes read-only call log, call analytics, recordings, directory, extension, and account diagnostics data as governed MCP tools, scoped per member by access level. It groups 17 tools into 5 categories, exposed through your firm's Weave MCP connection and filtered per member by access level.

## Input

- **extensionId** `string` (min length: 1) — Restrict the call log to a single extension/user (targets GET .../extension/{extensionId}/call-log instead of the company-wide log); "~" targets the currently authenticated extension. Omit for the company-wide call log.
- **dateFrom** `string(date-time)` (pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$) — Start of the time range to return call records for, RFC 3339 date-time (e.g. 2016-03-10T18:07:52.534Z). Defaults to dateTo minus 24 hours if omitted.
- **dateTo** `string(date-time)` (pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$) — End of the time range to return call records for, RFC 3339 date-time. Defaults to the current time if omitted.
- **direction** `string` (enum: "Inbound", "Outbound") — Only include calls in this direction. Omit to include both inbound and outbound calls.
- **type** `string` (enum: "Voice", "Fax") — Only include calls of this type. Omit to include all call types.
- **recordingType** `string` (enum: "Automatic", "OnDemand", "All") — Only include calls with a recording of this type. Omit to include calls with and without recordings.
- **view** `string` (enum: "Simple", "Detailed", default: "Detailed") — Level of detail for each returned record. Defaults to 'Detailed' (RingCentral's own API default is 'Simple') so callers get the fuller record — including per-leg breakdowns — without an explicit opt-in.
- **page** `integer` — Page number to retrieve (1-based). Defaults to 1.
- **perPage** `integer` — Page size (number of records). Defaults to 100.

## Output

- **uri** `string` — Link to the list of company/user call log records.
- **records** `array` (required) — List of call log records.
  - **[]** `object`
    - **extension** `object` — Extension on whose behalf the call was initiated (Boss extension, for Secretary call log).
      - **id** `integer` (required) — Internal identifier of the extension on whose behalf the call was initiated.
      - **uri** `string` (required) — Canonical URI of the extension resource.
    - **telephonySessionId** `string` — Telephony identifier of the call session.
    - **sipUuidInfo** `string` — Call session identifier, required for Telephony REST API.
    - **transferTarget** `object` — Present for a Warm Transfer: identifies the transfer target's telephony session.
      - **telephonySessionId** `string` — Telephony session identifier of the warm-transfer target.
    - **transferee** `object` — Present for a Warm Transfer: identifies the transferee's telephony session.
      - **telephonySessionId** `string` — Telephony session identifier of the warm-transfer transferee.
    - **partyId** `string` — Internal identifier of the call participant.
    - **transport** `string` (enum: "PSTN", "VoIP") — Type of call transport for this leg (PSTN or VoIP).
    - **from** `object` — Sender/initiator caller information.
      - **phoneNumber** `string` — Phone number of the party, usually plain (e.g. 18661234567) but sometimes formatted.
      - **extensionNumber** `string` — Extension short number, when the party communicated via an internal extension.
      - **extensionId** `string` — Internal identifier of the party's extension.
      - **name** `string` — Symbolic name associated with the party, when resolvable.
      - **location** `string` — Party location (city, state), when derivable from the phone number.
      - **device** `object` — Device that handled the call, when known.
        - **id** `string` (required) — Internal identifier of the device.
        - **uri** `string` (required) — Canonical URI of the device resource.
      - **dialerPhoneNumber** `string` — Dialer phone number without format modifications; returned for inbound calls.
    - **to** `object` — Target caller information.
      - **phoneNumber** `string` — Phone number of the party, usually plain (e.g. 18661234567) but sometimes formatted.
      - **extensionNumber** `string` — Extension short number, when the party communicated via an internal extension.
      - **extensionId** `string` — Internal identifier of the party's extension.
      - **name** `string` — Symbolic name associated with the party, when resolvable.
      - **location** `string` — Party location (city, state), when derivable from the phone number.
      - **device** `object` — Device that handled the call, when known.
        - **id** `string` (required) — Internal identifier of the device.
        - **uri** `string` (required) — Canonical URI of the device resource.
      - **dialedPhoneNumber** `string` — Dialed phone number without format modifications; returned for outbound calls.
    - **type** `string` (required, enum: "Voice", "Fax") — The type of call (Voice or Fax).
    - **direction** `string` (required, enum: "Inbound", "Outbound") — The direction of the call (Inbound or Outbound).
    - **message** `object` — Linked message (Fax/Voicemail), when one exists.
      - **id** `string` (required) — Internal identifier of the linked message.
      - **type** `string` (required) — Type of the linked message.
      - **uri** `string` (required) — Link to the linked message resource.
    - **delegate** `object` — Delegate extension that actually implemented the call action, when applicable.
      - **id** `string` (required) — Internal identifier of the Secretary extension that implemented the call action.
      - **name** `string` — Custom name of the Secretary extension.
    - **delegationType** `string` (enum: "Coworker", "Unknown") — Call delegation type, when applicable.
    - **action** `string` (required) — The internal action corresponding to the call operation.
    - **result** `string` — The result of the call operation.
    - **reason** `string` — The reason for the call result.
    - **reasonDescription** `string` — Detailed description of the call result reason.
    - **startTime** `string` (required) — Call start datetime, ISO 8601 with timezone (e.g. 2016-03-10T18:07:52.534Z).
    - **duration** `integer` (required) — Call duration, in seconds.
    - **durationMs** `integer` (required) — Call duration, in milliseconds.
    - **recording** `object` — Call recording data, when the call was recorded.
      - **id** `string` (required) — Internal identifier of the call recording.
      - **uri** `string` (required) — Link to the call recording metadata resource.
      - **type** `string` (required, enum: "Automatic", "OnDemand") — Recording mode used for this recording.
      - **contentUri** `string` (required) — Link to the recording's binary content. Requires RingCentral bearer authorization to fetch directly — prefer the get-call-recording / download-call-recording tools.
    - **shortRecording** `boolean` — True when the recording was too short and therefore is not returned. Omitted when false.
    - **billing** `object` — Billing information related to the call ('Detailed' view only).
      - **costIncluded** `number` — Cost per minute already included in the RingCentral service plan (e.g. international calls).
      - **costPurchased** `number` — Cost per minute paid and not included in the RingCentral service plan.
    - **internalType** `string` — The internal type of the call.
    - **id** `string` (required) — Internal identifier of the call log record.
    - **uri** `string` (required) — Canonical URI of the call log record.
    - **sessionId** `string` (required) — Internal identifier of the call session.
    - **deleted** `boolean` — Whether the record is deleted; returned for deleted records in ISync requests.
    - **legs** `array` — For 'Detailed' view only: per-leg breakdown.
      - **[]** `object`
        - **extension** `object` — Extension on whose behalf the call was initiated (Boss extension, for Secretary call log).
          - **id** `integer` (required) — Internal identifier of the extension on whose behalf the call was initiated.
          - **uri** `string` (required) — Canonical URI of the extension resource.
        - **telephonySessionId** `string` — Telephony identifier of the call session.
        - **sipUuidInfo** `string` — Call session identifier, required for Telephony REST API.
        - **transferTarget** `object` — Present for a Warm Transfer: identifies the transfer target's telephony session.
          - **telephonySessionId** `string` — Telephony session identifier of the warm-transfer target.
        - **transferee** `object` — Present for a Warm Transfer: identifies the transferee's telephony session.
          - **telephonySessionId** `string` — Telephony session identifier of the warm-transfer transferee.
        - **partyId** `string` — Internal identifier of the call participant.
        - **transport** `string` (enum: "PSTN", "VoIP") — Type of call transport for this leg (PSTN or VoIP).
        - **from** `object` — Sender/initiator caller information.
          - **phoneNumber** `string` — Phone number of the party, usually plain (e.g. 18661234567) but sometimes formatted.
          - **extensionNumber** `string` — Extension short number, when the party communicated via an internal extension.
          - **extensionId** `string` — Internal identifier of the party's extension.
          - **name** `string` — Symbolic name associated with the party, when resolvable.
          - **location** `string` — Party location (city, state), when derivable from the phone number.
          - **device** `object` — Device that handled the call, when known.
            - **id** `string` (required) — Internal identifier of the device.
            - **uri** `string` (required) — Canonical URI of the device resource.
          - **dialerPhoneNumber** `string` — Dialer phone number without format modifications; returned for inbound calls.
        - **to** `object` — Target caller information.
          - **phoneNumber** `string` — Phone number of the party, usually plain (e.g. 18661234567) but sometimes formatted.
          - **extensionNumber** `string` — Extension short number, when the party communicated via an internal extension.
          - **extensionId** `string` — Internal identifier of the party's extension.
          - **name** `string` — Symbolic name associated with the party, when resolvable.
          - **location** `string` — Party location (city, state), when derivable from the phone number.
          - **device** `object` — Device that handled the call, when known.
            - **id** `string` (required) — Internal identifier of the device.
            - **uri** `string` (required) — Canonical URI of the device resource.
          - **dialedPhoneNumber** `string` — Dialed phone number without format modifications; returned for outbound calls.
        - **type** `string` (required, enum: "Voice", "Fax") — The type of call (Voice or Fax).
        - **direction** `string` (required, enum: "Inbound", "Outbound") — The direction of the call (Inbound or Outbound).
        - **message** `object` — Linked message (Fax/Voicemail), when one exists.
          - **id** `string` (required) — Internal identifier of the linked message.
          - **type** `string` (required) — Type of the linked message.
          - **uri** `string` (required) — Link to the linked message resource.
        - **delegate** `object` — Delegate extension that actually implemented the call action, when applicable.
          - **id** `string` (required) — Internal identifier of the Secretary extension that implemented the call action.
          - **name** `string` — Custom name of the Secretary extension.
        - **delegationType** `string` (enum: "Coworker", "Unknown") — Call delegation type, when applicable.
        - **action** `string` (required) — The internal action corresponding to the call operation.
        - **result** `string` — The result of the call operation.
        - **reason** `string` — The reason for the call result.
        - **reasonDescription** `string` — Detailed description of the call result reason.
        - **startTime** `string` (required) — Call start datetime, ISO 8601 with timezone (e.g. 2016-03-10T18:07:52.534Z).
        - **duration** `integer` (required) — Call duration, in seconds.
        - **durationMs** `integer` (required) — Call duration, in milliseconds.
        - **recording** `object` — Call recording data, when the call was recorded.
          - **id** `string` (required) — Internal identifier of the call recording.
          - **uri** `string` (required) — Link to the call recording metadata resource.
          - **type** `string` (required, enum: "Automatic", "OnDemand") — Recording mode used for this recording.
          - **contentUri** `string` (required) — Link to the recording's binary content. Requires RingCentral bearer authorization to fetch directly — prefer the get-call-recording / download-call-recording tools.
        - **shortRecording** `boolean` — True when the recording was too short and therefore is not returned. Omitted when false.
        - **billing** `object` — Billing information related to the call ('Detailed' view only).
          - **costIncluded** `number` — Cost per minute already included in the RingCentral service plan (e.g. international calls).
          - **costPurchased** `number` — Cost per minute paid and not included in the RingCentral service plan.
        - **internalType** `string` — The internal type of the call.
        - **legType** `string` (required) — Leg type.
        - **master** `boolean` — For 'Detailed' view only: whether this leg is the master leg.
    - **lastModifiedTime** `string` — For 'Detailed' view only: datetime the record was last modified, ISO 8601 with timezone.
    - **finished** `boolean` — Whether the call session has finished. Live-observed on nonprod call-log records; not declared in the vendored CallLogRecord/BaseCallLogRecord spec component (documented live-only drift).
- **navigation** `object` (required) — Links to other pages of the current result set.
  - **firstPage** `object` — Link to the first page of results.
    - **uri** `string` — Canonical URI to retrieve the particular page of the result set.
  - **nextPage** `object` — Link to the next page of results.
    - **uri** `string` — Canonical URI to retrieve the particular page of the result set.
  - **previousPage** `object` — Link to the previous page of results.
    - **uri** `string` — Canonical URI to retrieve the particular page of the result set.
  - **lastPage** `object` — Link to the last page of results.
    - **uri** `string` — Canonical URI to retrieve the particular page of the result set.
- **paging** `object` (required) — Pagination metadata for `records`.
  - **perPage** `integer` (required) — Current page size (matches the perPage request parameter).
  - **page** `integer` — The current page number, 1-indexed.
  - **pageStart** `integer` — Zero-based index of the first element on the current page.
  - **pageEnd** `integer` — Zero-based index of the last element on the current page.
  - **totalPages** `integer` — Total number of pages in the dataset.
  - **totalElements** `integer` — Total number of elements in the dataset.