Merge API Documentation

Usage is a per-customer spend report over a date range, broken down by credential source (customer BYOK, org BYOK, or Merge-managed) and by model, provider, and routing policy. Use it to bill your own customers or to reconcile spend.

Path: /v1/customers/{customer_id}/usage. See Checking usage on the overview for the request; this page documents the response fields.

Fields

Field	Description	Type
`customer_byok_spend`	Spend billed against the customer’s own provider keys	number
`organization_byok_spend`	Spend billed against your organization’s provider keys	number
`merge_spend`	Spend billed against Merge-managed credentials	number
`request_count`	Number of requests	integer
`per_model` / `per_provider` / `per_routing_policy`	Spend breakdowns, sorted by spend descending	list of `{…, spend}`

The three spend fields are disjoint: their sum is the customer’s total spend for the range.