curl --request GET \
  --url https://api.inworld.ai/usage/v1/records \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.inworld.ai/usage/v1/records"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.inworld.ai/usage/v1/records', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "usageRecords": [
    {
      "startTime": "2026-08-21T00:00:00Z",
      "endTime": "2026-08-22T00:00:00Z",
      "group": {
        "model": "inworld-tts-2",
        "service": "tts"
      },
      "metrics": {
        "characters": {
          "value": "17250",
          "unit": "characters"
        }
      }
    },
    {
      "startTime": "2026-08-21T00:00:00Z",
      "endTime": "2026-08-22T00:00:00Z",
      "group": {
        "model": "gpt-4o-mini",
        "service": "llm"
      },
      "metrics": {
        "input_tokens": {
          "value": "21930",
          "unit": "tokens"
        },
        "output_tokens": {
          "value": "181",
          "unit": "tokens"
        },
        "cached_read_tokens": {
          "value": "3168",
          "unit": "tokens"
        }
      }
    }
  ],
  "nextPageToken": "",
  "readTime": "2026-08-28T17:31:51Z"
}

{
  "code": 123,
  "message": "<string>",
  "details": [
    {
      "@type": "<string>"
    }
  ]
}