---
title: "Fetch Inbox For Contact"
method: GET
path: "/api/v1/contacts/{contact_id}/inbox"
tags: ["include_in_client_gen"]
---

# Fetch Inbox For Contact

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

## Request

- Base URL: `https://app.sagecare.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://app.sagecare.ai/api/v1/contacts/{contact_id}/inbox`
- Auth: API key in header `X-Session-Token`

Get inbox (calls + recordings) for a specific contact.

Returns:
- Calls where the contact's phone numbers were involved
- Recordings directly associated with the contact
- Recordings associated with patients that have a PatientAssociation to this contact

All items sorted by timestamp (most recent first).

## Path parameters

- `contact_id` integer, required

## Query parameters

- `limit` integer
- `activity_types` string[]

## Response `200`

OK

- Inbox
  - `items` InboxItem[], required
    - `content` union, required
      - InboxCallItem
        - `item_type` 'call', required
        - `twilio_sid` string, required
        - `direction` union, required
          - 'inbound' | 'outbound'
          - string
        - `disposition` union
          - 'completed' | 'busy' | 'no-answer' | 'failed' | 'canceled' | 'voicemail' | 'voiceagent'
          - string
        - `summary` string
        - `from_participant` CallParticipant, required
          - `phone_number` string, required
          - `subject_type` union
            - 'patient' | 'contact' | 'user' | 'referrer' | 'referrer_institution' | 'organization'
            - string
          - `subject` Subject
            - `id` integer, required
            - `name` string, required
        - `to_participant` CallParticipant, required
          - `phone_number` string, required
          - `subject_type` union
            - 'patient' | 'contact' | 'user' | 'referrer' | 'referrer_institution' | 'organization'
            - string
          - `subject` Subject
            - `id` integer, required
            - `name` string, required
        - `placed_at` string, date-time, required
      - InboxRecordingItem
        - `item_type` 'recording', required
        - `id` integer, required
        - `duration_seconds` integer, required
        - `participants` RecordingAssociation[], required
          - `subject_type` union, required
            - 'patient' | 'contact' | 'user'
            - string
          - `subject` Subject, required
            - `id` integer, required
            - `name` string, required
        - `uploaded_by` Subject
          - `id` integer, required
          - `name` string, required
        - `created_at` string, date-time, required
        - `summary` string
        - `description` string
      - InboxEmailReferralItem
        - `item_type` 'email_referral', required
        - `activity_id` integer, required
        - `source` string, required
        - `description` string, required
        - `patient` Subject, required
          - `id` integer, required
          - `name` string, required
        - `created_at` string, date-time, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Content

---

[API](https://skmtc.dev/sagecare/apis/sage-api-v1.md) - [All operations](https://skmtc.dev/sagecare/apis/sage-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/sagecare/apis/sage-api-v1/revisions/36b26ceace69?raw)