Minutes used

GET https://app.sendapp.ai/api/voice/usage

Voice AI minutes month by month (at most 24 months) and, for the current month, the minutes included in the plan, used, bought and left. The same figures as the Voice AI page.

remaining_minutes is null when minutes are unlimited.

If the start is after the end the answer is 422 («The start of the range is after its end.»); a range longer than 24 months also answers 422.

Common errors: 401 API key missing or wrong — 403 plan without API access or without Voice AI, Voice AI app switched off, account suspended — 404 call or assistant that does not exist or is not yours — 422 invalid parameters — 429 too many requests: try again after the seconds given in Retry-After.

Parameters

3 · 1 required

apikey required

Your API Key (the X-API-Key header also works).

from optional

First month (2026-01 or a date). Default: the current month.

to optional

Last month. Default: the current month.

Need help with the integration? info@sendapp.live

Request

curl 'https://app.sendapp.ai/api/voice/usage?from=2026-09&to=2026-11' \
  -H 'X-API-Key: YOUR_API_KEY'

<?php
$ch = curl_init('https://app.sendapp.ai/api/voice/usage?from=2026-09&to=2026-11');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY'],
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/voice/usage?from=2026-09&to=2026-11', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
console.log(await res.json());

Response

{
  "status": "success",
  "usage": {
    "from": "2026-09",
    "to": "2026-11",
    "months": [
      { "month": "2026-09", "seconds_used": 41220, "minutes_used": 687, "calls": 302 },
      { "month": "2026-10", "seconds_used": 45960, "minutes_used": 766, "calls": 331 },
      { "month": "2026-11", "seconds_used": 6110, "minutes_used": 102, "calls": 47 }
    ],
    "month": "2026-11",
    "enabled": true,
    "unlimited": false,
    "included_minutes": 1000,
    "used_minutes": 102,
    "purchased_minutes": 0,
    "remaining_minutes": 898,
    "limit_reached": false
  }
}

{
  "status": "error",
  "message": "The range can cover at most 24 months."
}