Skip to main content
GET
Export credit usage as CSV

Authorizations

The full Cookie header copied from a signed-in connie.ai browser request. See the Authentication page.

Path Parameters

workspaceId
string<uuid>
required

The workspace id, as in the app URL connie.ai/<workspaceId>/....

Query Parameters

q
string

Search text, 2 to 200 characters.

Required string length: 2 - 200
period
enum<string>
default:30d

Time window. billing_period is the current billing period. custom uses from and to and is implied when either is given. Defaults to 30d.

Available options:
today,
7d,
30d,
billing_period,
custom
from
string

Start of a custom range, as YYYY-MM-DD or an ISO date-time. Only with period=custom.

to
string

End of a custom range, as YYYY-MM-DD (that whole day is included) or an ISO date-time.

movement
enum<string>

Only credits used, added, or refunded and adjusted.

Available options:
used,
added,
refunded_adjusted
category
enum<string>[]

One or more categories, repeated or comma-separated.

Available options:
ai,
enrichment,
workflow,
tool_integration,
grant,
purchase,
refund,
adjustment
action_key
string[]

One or more exact actions, such as tool.used. Repeated or comma-separated.

actor_id
string[]

Who triggered the event, as a user id or an API key id, or system. Repeated or comma-separated.

surface
enum<string>[]

Where the credits were used. Repeated or comma-separated.

Where the credits were used, such as Chat (ai_chat), MCP, an API key or a workflow.

Available options:
ai_chat,
mcp,
agent,
workflow,
ui_enrichment,
api_key,
managed_app,
system
record_id
string<uuid>[]

Only events charged to these records. Repeated or comma-separated.

amount_min
number

Smallest credit amount per event, ignoring sign.

Required range: x >= 0
amount_max
number

Largest credit amount per event, ignoring sign.

Required range: x >= 0
include_legacy
boolean
default:true

Include older imported history. Pass false to hide it.

Response

The CSV file. The X-Total-Events header gives the row count.

The response is of type string.