---
title: "Get Caller Card"
method: GET
path: "/api/v1/calls/{external_id}/caller-card"
tags: ["Caller Card"]
---

# Get Caller Card

`GET /api/v1/calls/{external_id}/caller-card`

## Request

- Base URL: `https://api.getanana.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getanana.com/api/v1/calls/{external_id}/caller-card`
- Auth: none declared

## Path parameters

- `external_id` string, required

## Response `200`

Successful Response

- CallerCardRead: Everything the Caller Card page renders, in one response.
  - `external_id` string, required
  - `status` string, required
  - `started_at` string, date-time, nullable, required
  - `customer_number` string, nullable, required
  - `agent_name` string, nullable, required
  - `headline` CallerCardHeadlineRead, required
    - `name` string, required
    - `reason` string, required
  - `caller` CustomerContext, required
    - `identity` CustomerIdentity, required
      - `name` string, nullable, required
      - `email` string, nullable, required
      - `phone` string, nullable, required
      - `loyalty_tier` string, nullable, required
      - `external_ids` ExternalId[]
        - `provider` string, required
        - `identifier_type` string, required
        - `identifier_value` string, required
    - `last_interaction` LastInteraction, required
      - `timestamp` string, date-time, required
      - `channel` string, required
      - `summary` string, required
      - `outcome` string, nullable
      - `sentiment` string, nullable
    - `active_issues` ActiveIssue[], required
      - `investigation_id` string, uuid, required
      - `headline` string, required
      - `category` string, required
      - `severity` string, required
      - `created_at` string, date-time, required
    - `risk_signals` object, required
    - `interaction_stats` object, required
    - `is_repeat_caller` boolean
    - `recent_trips` ContextTrip[], nullable
      - `property_code` string, nullable, required
      - `checkin` string, date, nullable, required
      - `checkout` string, date, nullable, required
      - `status` string, required
      - `party_size` integer, nullable, required
    - `phone_country` string, nullable
    - `likely_language` string, nullable
  - `briefing_facts` TransferBriefingFact[], required
    - `label` string, required
    - `value` string, required
  - `conversation` union[], required
    - union
      - CallerCardMessage: Something said on the call: by the caller, the AI, or a staff member.
        - `kind` 'message', required
        - `speaker` 'caller' | 'agent' | 'staff', required
        - `name` string, required
        - `text` string, required
        - `timestamp_ms` integer, required
      - CallerCardHandoffMarker: A "Send to…" of the card, where it falls in the conversation.
        - `kind` 'handoff', required
        - `label` string, required
        - `by` string, nullable, required
        - `timestamp_ms` integer, required
  - `owner` CallerCardOwner, required
    - `name` string, required
    - `is_me` boolean, required
  - `departments` CallerCardDepartment[], required
    - `key` string, required
    - `label` string, required
    - `people` integer, required
    - `lines` CallerCardLine[], required
      - `human_agent_id` string, uuid, required
      - `name` string, required
      - `number` string, required
      - `people` integer, required
  - `my_last_send` CallerCardSendStatus, required: Your latest "Send to…" of this card, and whether anyone has taken it.
    - `label` string, required
    - `sent_at` string, date-time, required
    - `taken_by` string, nullable, required

## Other responses

- `404`: No card for this call is available to you
- `422`: Validation Error

## Changes

> 55 revisions in range; 1 not diffed.

- **2026-10-20** `539e5769d27e`: 1 breaking
  - response property `caller/anyOf[subschema #1: CustomerContext]/recent_trips` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
- **2026-10-19** `e43c72aa3600`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/calls/:external_id/caller-card/get.md)

---

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