Docs

Per-day consumption and the credit ledger

GEThttps://server.heyrik.com/api/v1/usage

Headers

AuthorizationstringRequired

Use Bearer $HEYRIK_API_KEY with an account-scoped API key. Keep the key on your server.

Get your API key

Parameters 3

Fields documented for this operation. See the request example for placement and structure.

daysnumber

Window size. Default 30.

fromstring

ISO start date (use with until).

untilstring

ISO end date.

GET/usage
curl "https://server.heyrik.com/api/v1/usage?days=30" \
  -H "Authorization: Bearer $HEYRIK_API_KEY"
Response example
{
  "data": {
    "period": { "credits_used": 218.267, "minutes": 54.5, "calls": 83 },
    "by_day": [
      { "date": "2026-07-22", "credits": 12.45, "minutes": 3.1, "calls": 5 }
    ],
    "credits_per_minute": 4,
    "records": [
      {
        "kind": "call",
        "credits": 2.9167,
        "seconds": 37,
        "note": "call 37s — 2.4667 platform + 0.45 carrier"
      }
    ]
  }
}

Illustrative examples · No live request is sent

Docs

Build sophisticated voice experiences with HeyRik.

© 2026 HeyRik · Support