---
title: "List facts"
method: GET
path: "/v1/facts"
tags: ["Owner"]
---

# List facts

`GET /v1/facts`

## Request

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

## Query parameters

- `q` string
- `filter` 'all' | 'needs_check' | 'about_you' | 'person' | 'held_back'
- `contactId` string
- `cursor` string
- `limit` integer

## Response `200`

OK

- FactList
  - `items` Fact[], required
    - `id` string, required
    - `subject` string, required
    - `predicate` string, required
    - `object` string, required
    - `provenance` 'owner_stated' | 'owner_confirmed' | 'vicem_inferred' | 'third_party_claimed' | 'system_observed', required
    - `reliability` number, required
    - `validAt` string, date-time, required
    - `quarantined` boolean, required
    - `subjectLabel` string
    - `subjectContactId` string
    - `sentence` string
    - `recordedAt` string, date-time
    - `source` FactSource
      - `interactionId` string, required
      - `channel` 'call' | 'email' | 'sms' | 'link' | 'owner' | 'web', required
      - `counterpart` string, nullable, required
      - `at` string, date-time, required
      - `segmentSeq` integer, nullable, required
    - `history` FactVersion[]
      - `id` string, required
      - `object` string, required
      - `provenance` 'owner_stated' | 'owner_confirmed' | 'vicem_inferred' | 'third_party_claimed' | 'system_observed', required
      - `at` string, date-time, required
    - `usage` FactUsage
      - `calls` integer, required
      - `lastAt` string, date-time, required
  - `nextCursor` string, nullable, required
  - `needsCheck` integer
  - `needsCheckPeople` Id[]

## 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)