Skip to main content
GET
Get usage and recent charges
Authentication: workspace API key in Authorization: Bearer <key>.

Errors

Authorizations

Authorization
string
header
required

Create a workspace API key in the Deepline dashboard before calling authenticated endpoints.

Query Parameters

run_id
string

Filter recent charges and include spend for this exact public run ID.

request_id
string

Exact call lookup, at most 200 characters. Cannot be combined with run_id, recent_cursor, or recent_offset. Returns only org_id and recent.

recent_limit
integer
default:10

Recent page size; default 10, clamped to 100. Ignored for request_id.

Required range: 1 <= x <= 100
recent_offset
integer
default:0

Zero-based recent activity offset, at most 500. Follow recent.next_offset while recent.has_more is true.

Required range: 0 <= x <= 500
recent_cursor
string

Legacy cursor input. Prefer recent_offset; cannot be combined with request_id.

Response

Usage summary with recent activity, or the exact request lookup.

org_id
string
required
recent
object
required
balance
number
balance_display
string
rough_usd_balance
number
balance_updated_at
string | null
plan
object
managed_usd_per_email
number | null
has_payment_method
boolean
payment_method
object | null
usage
object
run
object | null
quota
object
autobill
object

Automatic recharge availability and settings; the fields depend on the workspace’s billing terms.