Skip to main content
POST
Run a cost query

Authorizations

Authorization
string
header
required

Send Authorization: Bearer <credential> using either a Clerk session JWT or a Clerk API key (ak_*). API keys may identify a user (user_*) or organization (org_*) principal and are generated in the Clerk Dashboard under API keys.

Body

application/json
queries
object[]
required
Required array length: 1 - 26 elements
datePreset
enum<string>
Available options:
TRAILING_90_DAYS,
TRAILING_30_DAYS,
TRAILING_45_DAYS,
TRAILING_7_DAYS,
TRAILING_3_DAYS,
TRAILING_14_WEEKS,
MTD,
QTD,
YTD,
LAST_WEEK,
LAST_MONTH,
LAST_6_MONTHS,
LAST_12_MONTHS,
LAST_4_YEARS,
LAST_3_MONTHS,
LAST_INVOICE_MONTH
from
string
Pattern: ^\d{4}-\d{2}-\d{2}$
to
string
Pattern: ^\d{4}-\d{2}-\d{2}$
aggBy
enum<string>
default:Month
Available options:
Hour,
Day,
Week,
Month,
Period
forecastDays
integer
Required range: x >= 0
compare
object
limit
integer
Required range: 1 <= x <= 1000
scopeId
string | null

Response

Query result, discriminated by kind

kind
enum<string>
required
Available options:
series
data
object
required
Last modified on August 10, 2026