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

# Contact timeline

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

## Request

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

## Path parameters

- `id` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

OK

- ContactTimelineResponse
  - `items` object[], required
    - `id` string, required
    - `kind` 'call' | 'text' | 'email' | 'link' | 'booking' | 'relay' | 'errand', required
    - `at` string, date-time, required
    - `interactionId` string, required
    - `label` string, required
    - `text` string, nullable, required
    - `open` boolean, required
    - `startsAt` string, date-time
    - `status` string
    - `deposit` 'asked' | 'unsent' | 'said_paid' | 'confirmed' | 'waived'
    - `outcome` string
  - `nextCursor` string, nullable, required

## Other responses

- `400`: Invalid request (body not JSON, or schema validation failed).
- `401`: Missing, expired or invalid bearer token.
- `404`: No such resource, or not visible to this caller.
- `500`: Unexpected server error (reported to Sentry).

---

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