---
title: "Get Contacts Known By"
method: POST
path: "/api/contacts/known-by"
tags: ["contacts"]
---

# Get Contacts Known By

`POST /api/contacts/known-by`

Batch known-by facts for a set of contacts: which org members know each
contact, with source + first/last-touch timestamps. Facts only — no
computed warmth score (explicit product decision, see the plan).

org_id-scoped like every other read here; a contact_id outside the
caller's org simply yields no rows (contact_known_by carries its own
org_id column, so no separate ownership check is needed).

## Query parameters

- `user_id` string, nullable
- `org_id` string, nullable

## Request body

- KnownByRequest
  - `contact_ids` string[], required

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/every/apis/every-api.md) · [All operations](https://skmtc.net/every/apis/every-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/every/every-api/revisions/438496ab3160/schema)