Fetch cost traces for a customer by external ID | Paid

import { PaidClient } from "@paid-ai/paid-node";
async function main() {
    const client = new PaidClient({
        token: "YOUR_TOKEN_HERE",
    });
    await client.customers.getCostsByExternalId("externalId", {});
}
main();

{
  "traces": [
    {
      "name": "trace.openai.agents.on_agent",
      "vendor": "openai",
      "cost": {
        "amount": 0.00001725,
        "currency": "USD"
      },
      "startTimeUnixNano": "1759774597906209000",
      "endTimeUnixNano": "1759774599194165000",
      "attributes": {
        "gen_ai": {
          "system": "openai",
          "operation": {
            "name": "on_agent"
          },
          "request": {
            "model": "gpt-4o-mini"
          },
          "usage": {
            "input_tokens": 27,
            "output_tokens": 22
          }
        },
        "external_customer_id": "your_external_customer_id",
        "external_product_id": "your_external_product_id"
      }
    },
    {
      "name": "trace.openai.agents.on_agent",
      "vendor": "openai",
      "cost": {
        "amount": 0.0000219,
        "currency": "USD"
      },
      "startTimeUnixNano": "1759774599472853000",
      "endTimeUnixNano": "1759774600619994000",
      "attributes": {
        "gen_ai": {
          "system": "openai",
          "request": {
            "model": "gpt-4o-mini"
          },
          "external_customer_id": "your_external_customer_id",
          "external_product_id": "your_external_product_id"
        }
      }
    }
  ],
  "meta": {
    "limit": 100,
    "offset": 0,
    "count": 2,
    "hasMore": false
  }
}

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

startTimedatetimeOptional

Filter traces starting from this time (ISO 8601 format)

endTimedatetimeOptional

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