Skip to main content
GET
Get timeline of activities and visits for a client

Authorizations

Authorization
string
header
required

Bearer token authentication

Path Parameters

clientId
string
required

Client UUID

Query Parameters

activity_type_id
number

Filter by activity type

contact_id
string

Filter by contact

date_from
string

Filter from date (ISO)

Example:

"2026-01-01"

date_to
string

Filter to date (ISO)

Example:

"2026-12-31"

include_emails
boolean
default:true

Include emails in timeline (default: true)

group_threads
boolean
default:true

Group emails by thread_id into conversations (default: true)

whatsapp_gap_hours
number
default:0

WhatsApp: split huge conversations into sessions when inactivity gap >= N hours (0 = no split). Recommended: 24.

Response

200 - application/json

Timeline items (activities + visits) sorted by date DESC

item_type
enum<string>
required

Tipo de item: activity, visit o task

Available options:
activity,
visit,
task
date
string<date-time>
required

Fecha del evento (para ordenamiento)

client_id
object | null
required

ID del cliente

activity_id
string

ID de la actividad (si item_type = activity)

contact_id
object

ID del contacto asociado

activity_type_id
number

ID del tipo de actividad

activity_type_name
string

Nombre del tipo de actividad

content
string

Contenido de la actividad o tarea

files_count
number

Cantidad de archivos adjuntos

contact_name
object

Nombre del contacto

created_by_name
object

Nombre del creador

external_source
object

Fuente externa (outlook, whatsapp, etc.)

external_id
object

ID externo en el sistema de origen

emailMeta
object

Metadatos de correo asociados a la actividad

whatsappMeta
object

Metadatos de WhatsApp asociados a la actividad

visit_detail_id
string

ID de la visita (si item_type = visit)

visit_date
object

Fecha de la visita

description
object

Descripción de la visita

visit_type_name
object

Tipo de visita

visit_status_name
object

Estado de la visita

technician_name
object

Nombre del técnico

address
object

Dirección de la visita

task_id
string

ID de la tarea

task_status
string

Estado de la tarea

assigned_to_name
object

Nombre del responsable asignado

isThread
boolean
default:false

Indica si este item es un thread agrupado de emails

threadCount
number

Cantidad de mensajes en el thread (cuando isThread = true)

threadMessages
array

Array de actividades que forman parte del thread (cuando isThread = true)

threadType
enum<string>

Tipo de hilo agrupado

Available options:
email,
whatsapp