Usage
Get usage history
GET
AI model charges, one per request, newest first. Music, sound effect and voice charges are not listed.
apiKeyheader
AuthorizationBearer <token>A Poko API key (poko_live_…) from Poko Motion → Settings → API.
workspace_id*stringWorkspace id. GET /api/me returns the key's default workspace (workspaceId); GET /api/workspace/mine lists all of them.
month?stringYYYY-MM. Leave out for all time.
Match
^\d{4}-\d{2}$limit?integerRange
1 <= value <= 200cursor?stringThe cursor from the previous page.
Success
application/json- response
success?booleandata?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 }}