Get customer usage

AuthorizationBearer

Your production key sent as a bearer token.

customer_idstringRequired

startstringOptional

endstringOptional

Successful Response

customer_byok_spenddouble

Spend billed against the customer’s own provider keys (USD)

organization_byok_spenddouble

Spend billed against your organization’s provider keys (USD)

merge_spenddouble

Spend billed against Merge-managed credentials (USD). The three spend fields are disjoint; their sum is the customer’s total spend for the range.

request_countinteger

Number of requests in the range

per_modellist of objects

Spend broken down per model, sorted by spend descending

per_providerlist of objects

Spend broken down per provider, sorted by spend descending

per_routing_policylist of objects

Spend broken down per routing policy, sorted by spend descending

1	{
2	"customer_byok_spend": 12.4,
3	"organization_byok_spend": 3.1,
4	"merge_spend": 8.75,
5	"request_count": 1284,
6	"per_model": [
7	{
8	"model": "openai/gpt-5.5",
9	"spend": 7.42
10	}
11	],
12	"per_provider": [
13	{
14	"provider": "openai",
15	"spend": 7.42
16	}
17	],
18	"per_routing_policy": [
19	{
20	"routing_policy": "2a1b3c4d-5e6f-4708-9a0b-1c2d3e4f5a6b",
21	"spend": 7.42
22	}
23	]
24	}

$	curl https://api-gateway.merge.dev/v1/customers/customer_id/usage \
>	-H "Authorization: Bearer <token>"