---
title: "Bounded contact context for an agent"
method: GET
path: "/v1/contacts/{id}/context"
tags: ["contacts"]
---

# Bounded contact context for an agent

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

## Request

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

One bounded view of a contact: the record, its companies, open opportunities, open tasks, and recent interactions.

## Path parameters

- `id` string, required

## Query parameters

- `interactions` integer: How many recent interactions to include in the brief. Bounded, and the answer says when the bound bit rather than implying it returned everything.
- `openTasks` integer: How many open tasks to include in the brief, bounded the same way.
- `openOpportunities` integer: How many open deals to include in the brief, bounded the same way.
- `relatedContacts` integer: How many of the account's contacts to include in the brief, bounded the same way.

## Response `200`

Success

- object
  - `contact` object, required: The contact record itself, with its custom values and tags.
    - `id` string, required
    - `displayName` string, required
    - `primaryEmail` string, required
    - `emailNormalized` string, required
    - `phone` string, required
    - `phoneNormalized` string, required
    - `title` string, required
    - `companyName` string
    - `lifecycle` object, required
      - `category` string, required
      - `label` string
    - `ownerActorId` string, required
    - `externalProvider` string, required
    - `externalId` string, required
    - `version` integer, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `archivedAt` string, required
  - `companies` object[], required: Companies this person is attached to. A contact may belong to more than one.
    - `id` string, required
    - `name` string, required
    - `domain` string, required
    - `domainNormalized` string, required
    - `website` string, required
    - `industry` string, required
    - `lifecycle` object, required
      - `category` string, required
      - `label` string
    - `ownerActorId` string, required
    - `externalProvider` string, required
    - `externalId` string, required
    - `version` integer, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `archivedAt` string, required
  - `openOpportunities` object[], required: Deals still open that this person is on, capped.
    - `id` string, required
    - `name` string, required
    - `pipelineId` string, required
    - `stageId` string, required
    - `status` 'open' | 'won' | 'lost', required
    - `amountMinor` integer, required
    - `currency` string, required
    - `probabilityBps` integer, required
    - `expectedCloseDate` string, required
    - `companyName` string
    - `lastActor` object
      - `id` string, required
      - `kind` 'human' | 'agent' | 'api_token' | 'system', required
      - `label` string, required
    - `ownerActorId` string, required
    - `externalProvider` string, required
    - `externalId` string, required
    - `version` integer, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `archivedAt` string, required
  - `openTasks` object[], required: Work still outstanding on this person, capped.
    - `id` string, required
    - `title` string, required
    - `status` 'open' | 'done' | 'cancelled', required
    - `assigneeActorId` string, required
    - `assignee` object
      - `id` string, required
      - `kind` 'human' | 'agent' | 'api_token' | 'system', required
      - `label` string, required
    - `dueAt` string, required
    - `priority` 'low' | 'normal' | 'high', required
    - `completedAt` string, required
    - `ownerActorId` string, required
    - `version` integer, required
    - `links` object[], required
      - `objectType` 'company' | 'contact' | 'opportunity', required
      - `objectId` string, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `archivedAt` string, required
  - `recentInteractions` object[], required: The most recent interactions with this person, newest first, capped. Summaries and metadata only: this product never stores a message body or a transcript.
    - `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
  - `standing` object, required: Per field: which kind of claim is standing on it, who asserted it, and when. This is the provenance the product is sold on, keyed by column name so it lines up with `changes`, `held[]` and the unconfirmed queue. `confirmed` means a person checked it and outranks everything an agent can assert; `inferred` is the weakest and is what an agent's own conclusion should carry. A write whose claim ranks below what is here is held rather than applied.
  - `limits` object, required: The cap applied to each collection above.
    - `interactions` integer, required
    - `openTasks` integer, required
    - `openOpportunities` integer, required
    - `relatedContacts` integer, required
  - `truncated` object, required: Which collections hit their cap, keyed by name. True means there is more that is not here.
  - `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)