---
title: "Get Field View Timeline"
method: GET
path: "/field-view/conversations/{conversation_id}/timeline"
tags: ["field-view"]
---

# Get Field View Timeline

`GET /field-view/conversations/{conversation_id}/timeline`

Returns the full conversation timeline for a technician.

Mixed timeline of messages, calls, timeline events, and notes — sorted by
created_at. Scoped to the authenticated technician. Marks unread inbound
messages as read.

## Path parameters

- `conversation_id` string, uuid, required

## Response `200`

Successful Response

- FieldViewTimelineResponse
  - `conversation_id` string, required
  - `customer_name` string, required
  - `customer_phone` string, required
  - `available_phones` FieldViewAvailablePhone[]
    - `phone` string, required
    - `label` string, required
    - `is_primary` boolean, required
  - `conversation_status` string, nullable
  - `items` FieldViewTimelineItem[], required
    - `type` string, required
    - `id` string, required
    - `direction` string, nullable
    - `body` string, nullable
    - `media_urls` FieldViewMediaItem[], nullable
      - `url` string, nullable
      - `content_type` string, nullable
      - `size` integer, nullable
    - `created_at` string, required
    - `sender_name` string, nullable
    - `user_id` string, nullable
    - `from_number` string, nullable
    - `call_status` string, nullable
    - `call_duration_seconds` integer, nullable
    - `event_type` string, nullable
    - `metadata` object, nullable
  - `summary` string, nullable
  - `call_to_action` string, nullable
  - `intent_priority` string, nullable
  - `technician_name` string, nullable
  - `estimate_low` number, nullable
  - `estimate_high` number, nullable
  - `job_type` string, nullable
  - `address` string, nullable
  - `read_only` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/noso/apis/crucible-backend-api.md) · [All operations](https://skmtc.dev/noso/apis/crucible-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/noso/apis/crucible-backend-api/revisions/db50150bcca5?raw)