---
title: "GET /voice/calls/contacts"
method: GET
path: "/voice/calls/contacts"
---

# GET /voice/calls/contacts

`GET /voice/calls/contacts`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/voice/calls/contacts`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Query parameters

- `agentId` string: Filter to one agent. Optional for master keys (omit for every agent in the org); ignored for agent keys, which always see only their own.
- `limit` number
- `offset` number

## Response `200`

OK

- object
  - `contacts` object[], required: Contacts, most recent call first
    - `counterparty` string, required: The other party's phone number (E.164)
    - `agentId` string, required: Agent that owns these calls
    - `callCount` integer, required: Total calls exchanged with this number
    - `missedCount` integer, required: Calls that were never answered. Counted from a missing answer timestamp rather than an end-reason, so declined, timed-out and failed calls all count as nobody picked up.
    - `lastCallAt` string, required: When the most recent call started — the sort key for this list
    - `lastCallDirection` 'INBOUND' | 'OUTBOUND', required: Whether the most recent call came in or went out
    - `totalDurationSeconds` integer, required: Seconds of connected time across every answered call with this number
  - `total` integer, required: Total contacts matching the query
  - `hasMore` boolean, required: Whether more contacts exist past this page

---

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