Submit cost and/or usage data

POST

https://api.agentpaid.io/api/v2/costs/bulk

POST

/api/v2/costs/bulk

1 import { PaidClient } from "@paid-ai/paid-node";
2 
3 const client = new PaidClient({ token: process.env.PAID_API_KEY! });
4 
5 async function main() {
6     const response = await client.costs.createCosts({
7         costs: [
8             {
9                 type: "cost",
10                 vendor: "anthropic",
11                 model: "claude-sonnet-4-5",
12                 customer: { customerId: "cus_5injMpsNzrT" },
13                 amount: 2.5,
14                 currency: "USD",
15             },
16             {
17                 type: "usage",
18                 customer: { externalCustomerId: "my-customer" },
19                 vendor: "openai",
20                 model: "gpt-4o-2024-08-06",
21                 usage: {
22                     inputTokens: 1200,
23                     outputTokens: 350,
24                 },
25             },
26             {
27                 type: "usage",
28                 customer: { externalCustomerId: "my-customer" },
29                 product: { externalProductId: "my-product" },
30                 vendor: "openai",
31                 model: "gpt-4o-2024-08-06",
32                 usage: {
33                     inputTokens: 800,
34                     outputTokens: 200,
35                 },
36             },
37         ],
38     });
39 
40     console.log(response);
41 }
42 
43 main().catch((err) => {
44     console.error(err);
45     process.exit(1);
46 });

1 {
2   "ingested": 1,
3   "duplicates": 1
4 }

Ingests a batch of cost records. Each record is either a pre-computed cost (caller supplies amount + currency) or a usage record (caller supplies vendor/model/token counts and Paid prices it server-side). The batch is all-or-nothing: if any record fails validation, the entire request is rejected with a 400 and nothing is persisted.

Authentication

AuthorizationBearer

API Key authentication using Bearer token

Request

Body

costslist of objectsRequired

Response

200

ingestedinteger>=0

Number of records persisted.

duplicatesinteger>=0

Number of records skipped because their idempotencyKey matched a previously ingested record.

Errors

400

Bad Request Error

403

Forbidden Error

500

Internal Server Error