---
title: "Recent interactions for a company"
method: GET
path: "/v1/companies/{id}/interactions"
tags: ["companies"]
---

# Recent interactions for a company

`GET /v1/companies/{id}/interactions`

## Request

- Base URL: `https://api.indraft.io`
- URL: `https://api.indraft.io/v1/companies/{id}/interactions`
- Auth: HTTP bearer

What was said, newest first, for one company. Interactions are summaries a caller wrote, never raw messages: Indraft never connects to mail and stores no transcript.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer: How many to return. The page bound is published in the schema call, and asking for more is refused rather than quietly truncated.

## Response `200`

Success

- object
  - `interactions` object[], required
    - `id` string, required
    - `interactionType` 'email' | 'call' | 'meeting' | 'message' | 'note', required
    - `direction` 'inbound' | 'outbound' | 'internal', required
    - `subject` string, required
    - `summary` string, required
    - `assertionKind` 'observed' | 'inferred' | 'imported' | 'user_supplied', required
    - `occurredAt` string, required
    - `sourceId` string, required
    - `createdByActorId` string, required
    - `actor` object
      - `id` string, required
      - `kind` 'human' | 'agent' | 'api_token' | 'system', required
      - `label` string, required
    - `links` object[], required
      - `objectType` 'company' | 'contact' | 'opportunity', required
      - `objectId` string, required
    - `createdAt` string, required
  - `requestId` string, required

## Other responses

- `401`: No credential, or one that has been revoked.
- `403`: Authenticated, and this capability is not held.
- `404`: No such record, or it belongs to another workspace.
- `422`: The request does not satisfy the schema on this page.
- `429`: Infrastructure protection tripped. This is not a product quota.
- `500`: A defect on our side. The hint says so, and carries an incident id.

---

[API](https://skmtc.dev/indraft/apis/indraft-api.md) · [All operations](https://skmtc.dev/indraft/apis/indraft-api/llms.txt) · [OpenAPI document](https://skmtc.dev/indraft/apis/indraft-api/revisions/d9bb05346d66?raw)