---
title: "GET /phone/sms/stats"
method: GET
path: "/phone/sms/stats"
---

# GET /phone/sms/stats

`GET /phone/sms/stats`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/phone/sms/stats`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Query parameters

- `agentId` string: Restrict to one agent. Omit for every agent in the org; ignored for agent keys, which always see only their own.

## Response `200`

OK

- object: Per-agent SMS conversation totals
  - `items` object[], required: One entry per agent that has at least one SMS conversation
    - `agentId` string, required: Agent these totals belong to
    - `conversations` integer, required: Distinct SMS conversations
    - `unread` integer, required: Unread inbound messages across those conversations
    - `lastMessageAt` string, nullable, required: Most recent message across those conversations, or null if none

---

[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)