Fetch cost traces for a customer by external ID | Paid

1 import { PaidClient } from "@paid-ai/paid-node"; 2 3 const client = new PaidClient({ token: "YOUR_TOKEN" }); 4 await client.customers.getCostsByExternalId("externalId", { 5 limit: 1, 6 offset: 1, 7 startTime: "2024-01-15T09:30:00Z", 8 endTime: "2024-01-15T09:30:00Z" 9 });

1 { 2 "traces": [ 3 { 4 "name": "trace.openai.agents.on_agent", 5 "vendor": "openai", 6 "cost": { 7 "amount": 0.00001725, 8 "currency": "USD" 9 }, 10 "startTimeUnixNano": "1759774597906209000", 11 "endTimeUnixNano": "1759774599194165000", 12 "attributes": { 13 "gen_ai": { 14 "system": "openai", 15 "operation": { 16 "name": "on_agent" 17 }, 18 "request": { 19 "model": "gpt-4o-mini" 20 }, 21 "usage": { 22 "input_tokens": 27, 23 "output_tokens": 22 24 } 25 }, 26 "external_customer_id": "your_external_customer_id", 27 "external_agent_id": "your_external_agent_id" 28 } 29 }, 30 { 31 "name": "trace.openai.agents.on_agent", 32 "vendor": "openai", 33 "cost": { 34 "amount": 0.0000219, 35 "currency": "USD" 36 }, 37 "startTimeUnixNano": "1759774599472853000", 38 "endTimeUnixNano": "1759774600619994000", 39 "attributes": { 40 "gen_ai": { 41 "system": "openai", 42 "request": { 43 "model": "gpt-4o-mini" 44 } 45 } 46 } 47 } 48 ], 49 "meta": { 50 "limit": 100, 51 "offset": 0, 52 "count": 2, 53 "hasMore": false 54 } 55 }

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path Parameters

externalIdstringRequired

The external ID of the customer

Query Parameters

limitintegerOptional1-1000Defaults to 100

Maximum number of traces to return (1-1000)

offsetintegerOptional>=0Defaults to 0

Number of traces to skip for pagination

startTimestringOptionalformat: "date-time"

Filter traces starting from this time (ISO 8601 format)

endTimestringOptionalformat: "date-time"

Filter traces up to this time (ISO 8601 format)

Response

Success response

traceslist of objects

metaobject

Pagination metadata for cost traces

Authentication

Path Parameters

Query Parameters

Response

Errors