---
title: "Contact card"
method: GET
path: "/v1/contacts/{id}/card"
tags: ["Owner"]
---

# Contact card

`GET /v1/contacts/{id}/card`

## Request

- Base URL: `https://api.vicem.ai`
- URL: `https://api.vicem.ai/v1/contacts/{id}/card`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

OK

- ContactCardResponse
  - `contactId` string, required
  - `nameSource` 'owner' | 'they_said', required
  - `saidName` string, nullable, required
  - `listingName` string, nullable, required
  - `who` object, nullable, required
    - `text` string, required
    - `state` 'auto' | 'confirmed' | 'edited' | 'removed', required
    - `provenance` 'owner_stated' | 'owner_confirmed' | 'vicem_inferred' | 'third_party_claimed' | 'system_observed', required
  - `usual` object, nullable, required
    - `text` string, required
    - `state` 'auto' | 'confirmed' | 'edited' | 'removed', required
    - `provenance` 'owner_stated' | 'owner_confirmed' | 'vicem_inferred' | 'third_party_claimed' | 'system_observed', required
  - `topics` object[], required
    - `topic` 'books' | 'callBack' | 'message' | 'asks' | 'texts' | 'emails', required
    - `count` integer, required
  - `bestTime` object, nullable, required
    - `days` 'weekdays' | 'weekends' | 'any', required
    - `from` integer, required
    - `to` integer, required
    - `samples` number, required
    - `state` 'auto' | 'confirmed' | 'edited' | 'removed', required
  - `language` object, nullable, required
    - `code` string, required
    - `state` 'auto' | 'confirmed' | 'edited' | 'removed', required
  - `note` string, nullable, required
  - `promises` object[], required
    - `id` string, required
    - `who` 'owner' | 'caller', required
    - `text` string, required
    - `dueAt` string, date-time, required
    - `interactionId` string, required
  - `counts` object, required
    - `calls` integer, required
    - `texts` integer, required
    - `emails` integer, required
    - `bookings` integer, required
    - `errands` integer, required
  - `firstAt` string, date-time, required
  - `lastAt` string, date-time, required
  - `built` boolean, required

## Other responses

- `401`: Missing, expired or invalid bearer token.
- `404`: No such resource, or not visible to this caller.
- `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)