Skip to main content
GET
List credit logs
Returns one entry per credit charge, newest first. Every workflow run, agent turn, copilot request, and MCP tool call that consumed credits appears here. Unlike operation logs, the credit ledger is not truncated by your plan. Your full history is available so you can reconcile against invoices.

Endpoint

Query Parameters

Example Request

Response

Credit Log Object

Service Object

credits_remaining is a point-in-time snapshot, not a running total you can reproduce by summing credits_used.The ledger records consumption only. When a billing period renews, your balance resets without writing an entry, so two consecutive entries can show the balance jumping upward. Use Get credit balance for the current figure rather than deriving it from the ledger.

Pagination

Identical to operation logs: read next_cursor and pass it back as cursor. Keep every other parameter unchanged while paging, and treat the cursor as opaque.

Cost Allocation Example

To total what one workflow cost over a period, filter by its service_id and sum:
Page through with next_cursor until has_more is false to cover the whole range. Use limit=1000 when exporting: a full page is only around 265 KB, so a year of history is a handful of requests rather than hundreds.
Credit charges do not map one-to-one onto operation logs. A single workflow run produces one operation log per node but a single credit entry, and agent and copilot usage is charged at the conversation level. Treat this ledger as the authoritative record of what you were charged.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

service_type
enum<string>

Filter by what was charged.

Available options:
workflow,
agent,
copilot,
mcp
service_id
string

Charges from one workflow, conversation, or MCP server.

user_id
string

Charges triggered by one team member.

created_after
integer<int64>

Only charges at or after this Unix second.

Required range: x >= 0
created_before
integer<int64>

Only charges at or before this Unix second.

Required range: x >= 0
limit
integer
default:25

Entries per page. The ceiling is higher than on other resources because ledger entries carry no payloads.

Required range: 1 <= x <= 1000
cursor
string

The next_cursor from the previous page. Keep every other filter unchanged while paging.

Response

Credit logs returned.

data
object[]
required
has_more
boolean
required

Whether more entries match beyond this page.

next_cursor
string | null

Pass back as cursor to fetch the next page. Null on the last page.