Costs

Cost breakdown and delivery statistics.

Cost Breakdown

GET /v1/runs/stats/costs?groupBy=costName
GET /v1/runs/stats/costs?groupBy=costName&brandId=brand_abc123
X-API-Key: dist_YOUR_KEY

Returns costs grouped by the specified dimension. Common groupBy values:costName, brandId, featureDynastySlug.

Delivery Stats

GET /v1/email-gateway/stats?brandId=brand_abc123
X-API-Key: dist_YOUR_KEY
{
  "emailsContacted": 500,
  "emailsSent": 480,
  "emailsDelivered": 460,
  "emailsOpened": 120,
  "emailsClicked": 25,
  "emailsReplied": 22,
  "emailsBounced": 20,
  "repliesInterested": 8,
  "repliesMeetingBooked": 3,
  "repliesClosed": 1,
  "repliesNeutral": 5,
  "repliesNotInterested": 3,
  "repliesOutOfOffice": 2,
  "repliesUnsubscribe": 0
}

TypeScript Client

const { groups } = await client.getCostBreakdown({
  groupBy: "costName",
  brandId: "brand_abc123",
});
const deliveryStats = await client.getBrandDeliveryStats("brand_abc123");