---
title: "Knows summary"
method: GET
path: "/v1/knows"
tags: ["Owner"]
---

# Knows summary

`GET /v1/knows`

## Request

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

## Response `200`

OK

- KnowsSummaryResponse
  - `people` integer, required
  - `named` integer
  - `places` 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
  - `placeCount` integer, required
  - `aboutYou` integer, required

## Other responses

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