# Usage and credits

What the Texa API counts, how it draws down your prepaid credits, and how to read this month's usage.


Texa Desk is prepaid, like a phone's airtime: your account holds a balance of credits, and what
Texa AI does draws it down. The API counts exactly as Texa Desk does, so a reply costs the same
whether it went out on WhatsApp or through your app.

## What is counted

| Meter | Counts |
|---|---|
| `conversations` | conversations opened with Texa AI in the loop |
| `messages_in` | customer messages Texa AI read |
| `ai_replies` | Texa AI's messages sent to customers |
| `ai_drafts` | Texa AI's drafts shown to people (suggest reply, shadow mode) |
| `handovers` | conversations Texa AI handed to people |
| `ai_resolutions` | conversations Texa AI closed as resolved without a person |
| `actions` | action requests run in your systems |
| `media_items`, `media_seconds` | voice notes, photos, documents and videos understood; seconds of audio and video transcribed |
| `voice_minutes` | minutes of Texa AI voice, on the phone and in your app |
| `sms_segments_out`, `sms_in` | SMS sent and received |
| `whatsapp_templates` | WhatsApp template messages sent |
| `campaign_sends` | campaign messages and calls |
| `research_responses` | completed surveys and interviews |
| `ask_questions` | questions put to Ask AI, including through [MCP](/guides/mcp) |
| `api_requests` | Texa API requests with a live key |
| `sandbox_requests` | Texa API requests with a test key: **free, up to 2,000 an account a month** |

Prices per meter are on [texadesk.com/pricing](https://texadesk.com/pricing) and in Texa Desk under
**Texa AI → Credits and billing**.

The sandbox is free so you can build without paying: test keys make up to 2,000 requests an account
a month at no charge. Over that, they answer `402` until the next month (ask Texa if you need more
while you build).

## This month's usage

```bash
curl https://api.texadesk.com/v1/usage -H "Authorization: Bearer $TEXA_API_KEY"
```

```json
{"month": "2026-10", "meters": [
  {"meter": "conversations", "description": "conversations opened with the AI in the loop", "quantity": 412},
  {"meter": "ai_replies", "description": "AI messages sent to customers", "quantity": 1830}
]}
```

Pass `month=2026-09` for an earlier month.

## When credits run out

The Texa API answers **402** (`insufficient_credits`) to anything that would be counted. Top up in
Texa Desk under **Texa AI → Credits and billing**, and requests work again at once.

- **At zero**, Texa AI is paused for the account, so conversations on your channels go to your team
  on the customer's next message. A top-up resumes it by itself (a pause a person set stays).
- **Warnings** go by email to your administrators at 20% and 5% of the credits last added, and at
  zero.
- **Credits expire** 12 months after the account last added credits; a notice goes 30 days before,
  and any top-up keeps the whole balance.