---
title: "Archive"
method: GET
path: "/v1/archive"
tags: ["Today"]
---

# Archive

`GET /v1/archive`

## Request

- Base URL: `https://api.vicem.ai`
- URL: `https://api.vicem.ai/v1/archive`
- Auth: HTTP bearer

## Query parameters

- `q` string
- `contactId` string
- `cursor` string
- `forwarded` '1'

## Response `200`

OK

- ArchiveRes
  - `items` Receipt[], required
    - `id` string, required
    - `ledgerEntryId` string, required
    - `at` string, date-time, required
    - `who` string, required
    - `whoNote` string
    - `what` string, required
    - `outcome` string, required
    - `mandateUsed` 'observe' | 'handle' | 'act' | 'policy', required
    - `undoUntil` string, date-time, required
    - `interactionId` string, required
    - `contactId` string
    - `channel` 'call' | 'email' | 'sms' | 'link' | 'owner' | 'web'
    - `risk` RiskLabel
      - `level` 'verify' | 'high', required
      - `text` string, required
      - `pattern` 'grandchild' | 'bank' | 'government' | 'tech_support' | 'prize' | 'delivery' | 'generic' | 'job'
    - `message` MessageFacts
      - `callback` MessageCallback, required
        - `e164` string, required
        - `source` 'stated' | 'caller_id' | 'heard_in_message' | 'none', required
        - `verified` boolean, required
      - `callerName` string, nullable, required
      - `callerCompany` string, nullable, required
      - `bestTimeToReach` string, nullable, required
      - `reason` 'personal' | 'work' | 'appointment' | 'delivery' | 'sales' | 'other', required
      - `email` object, nullable, required
        - `value` string, required
        - `verified` boolean, required
      - `replyRequested` boolean, required
    - `basis` ReceiptBasis
      - `kind` 'rule' | 'graduated' | 'approved', required
      - `text` string, required
      - `ledgerEntryId` string, required
      - `at` string, date-time, required
      - `sealShort` string, nullable, required
      - `firstFire` boolean
    - `askFirst` boolean
    - `state` ItemState
      - `readAt` string, date-time, required
      - `snoozedUntil` string, date-time, required
      - `doneAt` string, date-time, required
    - `snippet` string
    - `matchedIn` 'transcript' | 'summary' | 'fact'
    - `matchedSeq` integer
    - `forwardReason` 'busy' | 'no_answer' | 'unreachable' | 'unconditional' | 'other', nullable
  - `nextCursor` string, nullable, required

## Other responses

- `400`: Invalid request (body not JSON, or schema validation failed).
- `401`: Missing, expired or invalid bearer token.
- `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)