Sign in
logs

List Email Logs

Paginated, filterable list of email threads (newest activity first).

get/api/v1/logs/email

Query parameters

sourcestring nullable
contact_sourcestring nullable
account_idstring uuid nullable
include_spamboolean

Include threads the source marked as spam

Include threads the source marked as spam

last_direction'inbound' | 'outbound' nullable

Who spoke last (max sequence). Needs-reply is inbound.

Who spoke last (max sequence). Needs-reply is inbound.

local_hour_of_dayinteger nullable

Filter to threads stamped at this tenant-local hour (0-23); heatmap cell drill.

Filter to threads stamped at this tenant-local hour (0-23); heatmap cell drill.

local_day_of_weekinteger nullable

Filter to threads stamped on this tenant-local weekday (0=Mon..6=Sun); heatmap cell drill.

Filter to threads stamped on this tenant-local weekday (0=Mon..6=Sun); heatmap cell drill.

bucketsstring[] nullable

Filter to threads in any of these attribution buckets — the drill of a bucket-grouped Involvement cell.

Filter to threads in any of these attribution buckets — the drill of a bucket-grouped Involvement cell.

outcome'voicemail' | 'missed_by_system' | 'transferred' | 'handled_end_to_end' | '__null__' nullable

Filter by the thread's disposition, as voice and text do; 'null' = none stamped (the outcome chart's Unattributed).

Filter by the thread's disposition, as voice and text do; 'null' = none stamped (the outcome chart's Unattributed).

limitinteger nullable
offsetinteger nullable
pageinteger nullable

Deprecated - use offset.

Deprecated - use offset.

per_pageinteger nullable

Deprecated - use limit.

Deprecated - use limit.

start_datestring date nullable
end_datestring date nullable
date_fieldstring nullable

Which timestamp the date range filters. Valid values differ per subject; an unknown one is a 422 listing them.

Which timestamp the date range filters. Valid values differ per subject; an unknown one is a 422 listing them.

date_fromstring date-time nullable

Deprecated - use start_date.

Deprecated - use start_date.

date_tostring date-time nullable

Deprecated - use end_date.

Deprecated - use end_date.

use_created_atboolean nullable

Deprecated - use date_field=created_at.

Deprecated - use date_field=created_at.

property_ids_excludestring[] nullable
include_considered_hotelsboolean nullable

Include hotels the conversation was only considered for, not just the one it was attributed to.

Include hotels the conversation was only considered for, not just the one it was attributed to.

string uuid
OR
'__null__'
outcome_agent_refstring nullable
outcome_agent_refsstring[] nullable
outcome_agent_refs_excludestring[] nullable
outcome_agent_kind'ai_voice' | 'ai_text' | 'human' nullable
reviewedboolean nullable
statusstring nullable
has_booking_intentboolean nullable
has_bookingboolean nullable
booking_madeboolean nullable
booking_attributedboolean nullable
tag_idsstring[] nullable
countrystring nullable
selected_languagestring nullable
language_selection_sourcestring nullable
countriesstring[] nullable
countries_excludestring[] nullable
is_after_hoursboolean nullable
population_filtersstring[] nullable

Named conversation-population filters: business_hours, min_call_25s, real_customer_message, exclude_spam_test, dedupe_24h.

Named conversation-population filters: business_hours, min_call_25s, real_customer_message, exclude_spam_test, dedupe_24h.

searchstring nullable
standard_filtersstring nullable
metric_filtersstring nullable
sort_bystring nullable
sort_order'asc' | 'desc' nullable
strictboolean

Reject filters this subject cannot apply with a 422, instead of returning a wider population and reporting them in ignored_filters.

Reject filters this subject cannot apply with a 422, instead of returning a wider population and reporting them in ignored_filters.

voice_agent_idstring uuid nullable

Deprecated - use agent_id.

Deprecated - use agent_id.

metric_idstring uuid nullable

Deprecated - use metric_filters.

Deprecated - use metric_filters.

metric_state'pass' | 'fail' | 'na' | 'not_run' | 'error' nullable

Deprecated - use metric_filters.

Deprecated - use metric_filters.

booking_intentboolean nullable

Deprecated - use has_booking_intent.

Deprecated - use has_booking_intent.

Response

Successful Response

totalinteger required

Rows matching the filters, in total_units.

limitinteger required

Page size actually applied.

offsetinteger required

Rows skipped.

has_moreboolean required

Whether another page exists.

total_unit'logical_call' | 'row'

What total counts. row for text, email and bookings. voice returns logical_call, because a transferred call is several legs in items but one call in total — so a caller that counts items will legitimately disagree with total.

applied_filtersstring[]

Filters that were compiled into the query.

pageinteger nullable

Deprecated — derive from offset/limit.

per_pageinteger nullable

Deprecated — use limit.

Changes

Changed in 4 of the 28 revisions of this API.16

  • 704de2d43c7511See the full diff
    • ●

      for the query request parameter property_ids, the type of property anyOf[subschema #1]/items/ changed from string to no type, and format from uuid to no format

      request-parameter-property-type-changed

    • ○

      added the new optional query request parameter outcome

      new-optional-request-parameter

  • 202b7d85683e2See the full diff
    • ○

      added the new optional query request parameter language_selection_source

      new-optional-request-parameter

    • ○

      added the new optional query request parameter selected_language

      new-optional-request-parameter

  • a9141b6e4e7e1See the full diff
    • ○

      added the new optional query request parameter buckets

      new-optional-request-parameter

  • fbb95eac39652See the full diff
    • ○

      added the new optional query request parameter last_direction

      new-optional-request-parameter

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

Of the 28 revisions, 1 has no diff computed.