---
title: "People home"
method: GET
path: "/v1/people"
tags: ["Owner"]
---

# People home

`GET /v1/people`

## Request

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

## Response `200`

OK

- PeopleHomeResponse
  - `aboutYou` integer, required
  - `alwaysReaches` object[], required
    - `id` string, required
    - `name` string, required
  - `recent` object[], required
    - `key` string, required
    - `contactId` string, required
    - `who` string, required
    - `number` string, required
    - `verb` string, required
    - `outcomeKind` 'booked' | 'moved' | 'cancelled' | 'reminded' | 'message_taken' | 'callback_asked' | 'callback_promised' | 'callback_kept' | 'callback_late' | 'scam_stopped' | 'spam_stopped' | 'campaign_stopped' | 'scam_not_ended' | 'silent' | 'put_through' | 'rang_no_pickup' | 'rang_no_pickup_hung_up' | 'told_them' | 'chip_callback' | 'texted_back' | 'emailed' | 'relayed' | 'photos' | 'automated' | 'receipt_confirmed' | 'errand' | 'hung_up_silent' | 'hung_up_no_message' | 'ended_abusive' | 'line_dropped' | 'answered', nullable
    - `at` string, date-time, required
    - `interactionId` string, required
    - `channel` 'call' | 'email' | 'sms' | 'link' | 'owner' | 'web', required
    - `scam` boolean, required
    - `calls` integer
  - `blocked` 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)