---
title: "Get Correspondence"
method: GET
path: "/api/v1/contacts/{contact_id}/correspondence"
tags: ["Contact Correspondence"]
---

# Get Correspondence

`GET /api/v1/contacts/{contact_id}/correspondence`

## Path parameters

- `contact_id` string, uuid, required

## Query parameters

- `channels` string[] — Channels to include. Repeat the parameter or use comma-separated values.
- `after` string, date-time, nullable
- `before` string, date-time, nullable
- `limit_per_channel` integer
- `email_limit` integer, nullable
- `sms_limit` integer, nullable
- `imessage_limit` integer, nullable
- `calls_limit` integer, nullable
- `cursor` string, nullable
- `order` 'asc' | 'desc'
- `content` 'metadata' | 'preview' | 'full'
- `transcripts` 'none' | 'abridged' | 'full'
- `include_failed` boolean
- `identity_id` string, uuid, nullable

## Response `200`

Successful Response

- ContactCorrespondenceResponse
  - `contact_id` string, uuid, required
  - `identity_id` string, uuid, required
  - `items` union[], required
    - union
      - EmailCorrespondenceItem
        - `source_id` string, uuid, required
        - `direction` 'inbound' | 'outbound', required
        - `occurred_at` string, date-time, required
        - `identity_id` string, uuid, required
        - `status` string, nullable
        - `detail_url` string, nullable
        - `channel` 'email'
        - `mailbox_email` string, required
        - `thread_id` string, uuid, nullable
        - `from_address` string, required
        - `to_addresses` string[], required
        - `cc_addresses` string[]
        - `bcc_addresses` string[]
        - `subject` string, nullable
        - `snippet` string, nullable
        - `body_text` string, nullable
        - `content_unavailable` boolean
        - `attachments` CorrespondenceAttachmentMetadata[]
          - `filename` string, nullable
          - `content_type` string, nullable
          - `size` integer, nullable
      - SmsCorrespondenceItem
        - `source_id` string, uuid, required
        - `direction` 'inbound' | 'outbound', required
        - `occurred_at` string, date-time, required
        - `identity_id` string, uuid, required
        - `status` string, nullable
        - `detail_url` string, nullable
        - `channel` 'sms'
        - `conversation_id` string, uuid, required
        - `local_resource_id` string, uuid, required
        - `local_phone_number` string, required
        - `sender_phone_number` string, nullable
        - `participants` string[], required
        - `matched_contact_phone` string, required
        - `is_group` boolean, required
        - `text` string, nullable
        - `media` CorrespondenceMediaMetadata
          - `count` integer, required
      - IMessageCorrespondenceItem
        - `source_id` string, uuid, required
        - `direction` 'inbound' | 'outbound', required
        - `occurred_at` string, date-time, required
        - `identity_id` string, uuid, required
        - `status` string, nullable
        - `detail_url` string, nullable
        - `channel` 'imessage'
        - `conversation_id` string, uuid, required
        - `remote_handle` string, required
        - `sender_handle` string, nullable
        - `participants` string[]
        - `is_group` boolean
        - `service` string, required
        - `text` string, nullable
        - `media` CorrespondenceMediaMetadata
          - `count` integer, required
      - CallCorrespondenceItem
        - `source_id` string, uuid, required
        - `direction` 'inbound' | 'outbound', required
        - `occurred_at` string, date-time, required
        - `identity_id` string, uuid, required
        - `status` string, nullable
        - `detail_url` string, nullable
        - `channel` 'calls'
        - `remote_phone_number` string, required
        - `local_phone_number` string, nullable
        - `started_at` string, date-time, nullable
        - `ended_at` string, date-time, nullable
        - `duration_seconds` integer, nullable
        - `transcript` CorrespondenceTranscriptEntry[], nullable
          - `id` string, uuid, nullable
          - `seq` integer, nullable
          - `party` string, nullable
          - `text` string, nullable
          - `ts_ms` integer, nullable
          - `marker` 'abridged', nullable
          - `omitted_turns` integer, nullable
          - `omitted_ms` integer, nullable
        - `transcript_abridged` boolean
        - `transcript_unavailable` boolean
  - `channels` CorrespondenceChannelResult[], required
    - `channel` 'email' | 'sms' | 'imessage' | 'calls', required
    - `status` 'available' | 'no_identifier' | 'no_resource', required
    - `returned` integer, required
  - `next_cursor` string, nullable

## Other responses

- `422` — Validation Error
- `4XX` — Client error with Support Agent information.
- `5XX` — Server error with Support Agent information.

---

[API](https://skmtc.dev/inkbox/apis/inkbox-api.md) · [All operations](https://skmtc.dev/inkbox/apis/inkbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/inkbox/inkbox-api/revisions/31f357e7e6f8/schema)