Usage By Language

{
  "data": {
    "range": null,
    "timezone": "America/New_York",
    "period": {
      "start": "2024-04-01T00:00:00-04:00",
      "end": "2024-04-01T23:59:59-04:00"
    },
    "activity_view": "daily",
    "languages": [
      {
        "locale_code": "en-US",
        "display_name": "English (United States)",
        "share": 0.65,
        "credits": 1300,
        "characters": 65000,
        "lines": 1200,
        "allocation_basis": "characters"
      },
      {
        "locale_code": "es-ES",
        "display_name": "Spanish (Spain)",
        "share": 0.25,
        "credits": 500,
        "characters": 25000,
        "lines": 450,
        "allocation_basis": "characters"
      },
      {
        "locale_code": "fr-FR",
        "display_name": "French (France)",
        "share": 0.1,
        "credits": 200,
        "characters": 10000,
        "lines": 180,
        "allocation_basis": "characters"
      }
    ],
    "total_credits": 2000,
    "untagged_credits": 50
  },
  "meta": {
    "request_id": "a1b2c3d4-e5f6-7890-abcd-1234567890ef",
    "timestamp": "2024-04-01T23:59:59-04:00"
  }
}

Return workspace generated-audio usage grouped by language.

share is a 0..1 fraction. When activity_view is supplied, rows use that tab’s local-calendar period; otherwise they preserve legacy range behavior.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Query parameters

rangeenumOptionalDefaults to 30d

Rolling local calendar-day range.

Allowed values:

activity_viewenum or nullOptional

Optional activity view period to align language rows with the selected Usage tab. When supplied, range is ignored and range in the response is null.

Allowed values:

timezonestringOptionalDefaults to UTC

IANA timezone for local day bucketing.

Response

Successful Response

dataobject

metaobject

Errors

422

Unprocessable Entity Error

$	curl https://api.onepin.ai/api/v1/usage/by-language \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"

Authentication

Headers

Query parameters

Response

Errors