---
title: "Contact activity timeline"
method: GET
path: "/v1/contacts/{id}/timeline"
tags: ["Contacts"]
---

# Contact activity timeline

`GET /v1/contacts/{id}/timeline`

## Request

- Base URL: `https://api.volanea.com`
- URL: `https://api.volanea.com/v1/contacts/{id}/timeline`
- Auth: HTTP bearer

The contact plus their most recent 100 activities — events and emails merged, newest first.

## Path parameters

- `id` string, required

## Response `200`

The merged timeline.

- object
  - `contact` Contact, required
    - `contactId` string, required
    - `projectId` string
    - `email` string, email, required
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `subscribed` boolean, required
    - `data` object, nullable: Arbitrary custom fields.
    - `locale` string, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `timeline` union[], required
    - union
      - object: An event entry.
        - `kind` 'event', required
        - `at` integer, required: Unix ms.
        - `name` string, required
        - `data` object, nullable
        - `emailId` string, nullable
      - object: An email entry.
        - `kind` 'email', required
        - `at` integer, required: Unix ms.
        - `emailId` string, required
        - `subject` string, required
        - `source` string
        - `status` string

## Other responses

- `401`: Missing or invalid API key.
- `404`: Not found.
- `422`: Request validation failed (code `validation_error`, 422).

---

[API](https://skmtc.dev/volanea/apis/volanea-api.md) · [All operations](https://skmtc.dev/volanea/apis/volanea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volanea/apis/volanea-api/revisions/9e187ae84fda?raw)