Exporting your Agent Detail Records (ADRs) to an external billing/rating engine
Column | Type | Example | Description |
---|---|---|---|
timestamp | integer | 1750201280950 | Unix epoch time in milliseconds (UTC) when the billable event was written. |
timestampISO | text | 2025-06-17T23:01:20.950Z | ISO-8601 rendering of timestamp in UTC. Easiest for human reading and SQL TIMESTAMP casting. |
resellerId | text | 1534562 | Partner files only. Unique ID of the child reseller that owns the event. |
orgId | text | 1534562 | Partner & Reseller files. Customer organization that generated the usage. |
agentId | text | gpt4o-partner-1 | AI Agent Id that produced the billing event. This may be the same value as the orgId if the default agent for the organization was used. |
productItem | text | pstn-inbound-voice | Billable SKU code. |
billedQuantity | integer | 126 | Billed quantity of the product item unit of measure (e.g. minutes, messages, or token counts) the Vida system billed. This may not match what your system will use for billing increments. See quantity. |
quantity | integer | 126 | Raw measured usage before rounding from Vida platform. In case of voice minutes, this will be the raw seconds billed without any rounding adjustment as represented in billedQuantity. Identical to billedQuantity when no adjustment is needed. |
selfTesting | boolean (as text) | false | ”true” when the usage was created due to a customer self testing their AI agent. These are specially flagged in case you wish not to bill these particular use cases. |
srcAddress | text | +12165551234 | Originating phone number or email address that interacted with the AI Agent. Depending on which channel was used for communication (voice, sms, or email). This could be the AI Agent’s address or remote address depending on the direction specified in the product item. |
destAddress | text | +14405559999 | Destination phone number or email address that interacted with the AI Agent. Depending on which channel was used for communication (voice, sms, or email). This could be the AI Agent’s address or remote address depending on the direction specified in the product item. |
externalAccountId | text | acct-A1B2C3 | Arbitrary identifier you supplied on the AI Agent. This may map to your internal CRM or other external system for account reconciliation. |
externalBillingId | text | cust_ddk77d | Arbitrary billing identifier you supplied on the AI Agent. This is useful for mapping AI Agents to accounts or sub accounts in your billing system. This may also match the Stripe or Chargbee Id if connected. |