What the CRM already knows about a contact, for a live voice agent

Returns facts only, never instructions. checklist is the qualification checklist the contact record shows as primary (voice or text). last_call is the newest connected Voice AI call with a summary. A part that fails or exceeds the time budget is null and named in unavailable. Requires a workspace API key with contacts read.

GET

https://api.channelautomation.com/api/v1/voice-lookup/contacts/{contactId}/context

Authorization

ApiKeyAuth
API key in header
required

Path parameters

contactId
string
required
format: uuid

Returns

200

Context for the contact

400

contactId is not a UUID

401

Missing or invalid API key

403

Key lacks contacts read

404

Contact not found in the key's workspace

What the CRM already knows about a contact, for a live voice agent

curl --request GET \
  --url 'https://api.channelautomation.com/api/v1/voice-lookup/contacts/<contactId>/context' \
  --header 'X-API-Key: <X-API-Key>'

const url = 'https://api.channelautomation.com/api/v1/voice-lookup/contacts/<contactId>/context';
const options = {method: 'GET', headers: {'X-API-Key': '<X-API-Key>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.channelautomation.com/api/v1/voice-lookup/contacts/<contactId>/context"

headers = {"X-API-Key": "<X-API-Key>"}

response = requests.get(url, headers=headers)

print(response.text)

Response example

{
  "success": true,
  "data": {
    "contact_id": "1c916dcd-f50b-43bd-bd86-ba59b0c58134",
    "checklist": {
      "source": "voice",
      "as_of": "2026-10-27T22:00:57Z",
      "qualified": false,
      "answered": 10,
      "total": 11,
      "steps": [
        {
          "question": "Product / interest confirmed",
          "answer": "Bath",
          "status": "captured"
        },
        {
          "question": "Co owner",
          "answer": null,
          "status": "missing"
        }
      ]
    },
    "last_call": {
      "at": "2026-10-29T15:35:51Z",
      "agent": "Confirmation Agent v2 (Inbound)",
      "direction": "inbound",
      "duration_seconds": 199,
      "summary": "Caller confirmed the Friday 10 AM bath consultation."
    },
    "unavailable": []
  }
}