Poko API
Usage

Get usage history

GET
/api/motion-billing/usage-history

AI model charges, one per request, newest first. Music, sound effect and voice charges are not listed.

Authorization

apiKey
headerAuthorizationBearer <token>

A Poko API key (poko_live_…) from Poko Motion → Settings → API.

Query Parameters

workspace_id*string

Workspace id. GET /api/me returns the key's default workspace (workspaceId); GET /api/workspace/mine lists all of them.

month?string

YYYY-MM. Leave out for all time.

Match^\d{4}-\d{2}$
limit?integer
Range1 <= value <= 200
cursor?string

The cursor from the previous page.

Response Body

Success

application/json
  1. response
success?boolean
data?
Example Request
curl -X GET 'https://api.poko.video/api/motion-billing/usage-history?workspace_id=string'
Example Response
{  "success": true,  "data": {    "items": [      {        "userId": "user_2Nf7QxKp4TzLm9WbRc3HvYd8EaJ",        "model": "poko-pulse",        "inputTokens": 18234,        "outputTokens": 2210,        "cacheCreationTokens": 0,        "cacheReadTokens": 41200,        "costUsd": 0.0312,        "projectId": "Pj4kT9wQzN",        "workspaceId": "Wk7pQ2xR",        "createdAt": "2026-11-05T08:58:12.481Z",        "projectName": "Acme launch video"      }    ],    "next_cursor": "TExNX1VTQUdFIzIwMjYtMTEtMDVUMDg6NTg6MTIuNDgxWiNRejdtSzJwTHhS",    "has_more": true  }}