Billing and usage
string · date-time · requiredinteger · int64 · requiredinteger · int64 · requiredinteger · int64 · requiredinteger · int64 · requiredstring · requiredinteger · int32 · requiredinteger · int64 · requiredinteger · int64 · requiredstring · requiredboolean · requiredinteger · int64 · requiredinteger · int64 · requiredBillingAccountState · enum · requiredBillingAccountStatus · enum · requiredinteger · int64 · min: 0 · requiredinteger · int64 · min: 0 · requiredinteger · int64 · min: 0 · requiredinteger · int64 · min: 0 · required
Properties for Variant 1:string · enum · requiredstring | null · requiredBillingDocumentFormat · enum · requiredstring | null · requiredstring | null · requiredstring · date-time · requiredstring · requiredinteger · int32 · requiredboolean · requiredstring | null · requiredstring · requiredstring | null · date-time · requiredBillingDocumentKind · enum · requiredinteger | null · int64 · requiredstring | null · requiredstring | null · requiredstring | null · requiredstring | null · requiredBillingDocumentStatus · enum · requiredstring | null · requiredinteger | null · int64 · requiredstring · requiredinteger | null · int64 · requiredstring | null · requiredstring · requiredstring | null · date-time · requiredBillingDocumentKind · enum · requiredinteger | null · int64 · requiredstring | null · requiredstring | null · requiredstring | null · requiredstring | null · requiredBillingDocumentStatus · enum · requiredstring | null · requiredinteger | null · int64 · requiredstring · requiredinteger | null · int64 · requiredstring · requiredinteger · int32 · requiredstring | null · requiredstring | null · requiredinteger · int64 · requiredstring · requiredstring · requiredinteger · int32 · requiredstring · requiredstring · requiredinteger · int64 · requiredinteger · int64 · requiredstring · requiredarray | null · requiredstring · date-time · requiredstring · requiredstring · requiredinteger · int64 · requiredinteger | null · int64 · min: 0 · requiredstring | null · date-time · requiredstring | null · requiredstring · requiredstring | null · date-time · requiredBillingDocumentKind · enum · requiredinteger | null · int64 · requiredstring | null · requiredstring | null · requiredstring | null · requiredstring | null · requiredBillingDocumentStatus · enum · requiredstring | null · requiredinteger | null · int64 · requiredstring · requiredinteger | null · int64 · requiredinteger · int64 · requiredstring · requiredinteger · int32 · requiredinteger · int32 · requiredinteger · int64 · requiredstring · requiredboolean · requiredinteger · int64 · requiredinteger · int64 · requiredinteger · int64 · requiredstring · requiredstring · requiredstring | null · requiredstring | null · requiredBillingStatementLineSign · enum · requiredboolean · requiredinteger · int64 · requiredstring · requiredstring · requiredinteger · int32 · min: 0 · requiredstring · requiredstring · requiredstring · required string · requiredstring · requiredstring · requiredinteger · int32 · min: 0 · requiredstring · requiredstring · requiredstringstring[]stringstringstringinteger · int64 · requiredstring · date-time · requiredinteger · int64 · requiredstring · date-time · requiredstring · requiredstring · date-time · requiredstring | null · date-time · requiredRateCoverageGapKind · enum · requiredstring · requiredinteger | null · int64 · requiredstring | null · requiredstring[] · requiredstring · date-time · requiredinteger · int64 · requiredstring · requiredstring · requiredstring · requiredstring · requiredstring · requiredinteger · int64 · requiredstring · requiredstring[] · requiredstring · requiredstring · requiredstring · requiredstring · requiredinteger · int32 · requiredinteger · int32 · requiredstring | null · requiredstring · date-time · requiredstring | null · requiredboolean · requiredstring · requiredstring · requiredRateDirection · enum · requiredinteger · int64 · requiredstring · date-time · requiredinteger · int64 · requiredstring · requiredinteger · int64 · requiredstring · date-time · requiredinteger · int64 · requiredstring · requiredinteger · int64 · requiredstring · date-time · requiredinteger · int64 · requiredinteger · int64 · requiredinteger · int64 · requiredinteger · int64 · requiredinteger · int64 · requiredinteger · int64 · requiredinteger · int64 · requiredstring · date · requiredboolean · requiredinteger · int64 · requiredinteger · int64 · requiredCallSourceProduct · enum · requiredinteger · int64 · min: 0 · requiredinteger · int64 · min: 0 · requiredinteger · int64 · min: 0 · requiredinteger · int64 · min: 0 · requiredinteger · int64 · min: 0 · requiredinteger · int64 · requiredinteger | null · int64 · requiredstring · requiredstring | null · uuid · requiredinteger · int64 · requiredinteger · int64 · requiredstring · requiredstring · requiredinteger · int64 · requiredstring | null · requiredUsageDimension · enum · requiredstring · requiredstring · requiredstring | null · requiredstring · date-time · requiredstring · requiredUsageDimension · enum · requiredinteger · int64 · min: 0 · required
Schemas
BillingAccount
as_ofavailable_minorrequired
Calls refused since the hard stop began; not counted on this route yet, so always null.
capacity_minorrequired
When cash went below zero; not recorded yet, so always null.
cash_minorcredit_limit_minorcurrencyrequired
Hours until available cash runs out at the current spend; not estimated yet, so always null.
exponentexposure_minorholds_minoridliverequired
The balance below which the account counts as low; not configurable yet, so always null.
BillingPromoPool[] · required
required
The code calls are refused with during a stop; not reported here yet, so always null.
required
When calls began to be refused; not reported here yet, so always null.
reserved_cash_minorrequired
How many live calls hold reserved cash; not counted yet, so always null.
revisionstateEnum values:
hard_stop_over_limit
unfunded
low_using_credit
promo_carrying
healthy
statusEnum values:
active
suspended
closed
required
The suspension in force on the account; not reported yet, so always null.
required
The unpaid invoice holding the account; not reported yet, so always null.
BillingAccountState
string · enum
Enum values:
hard_stop_over_limit
unfunded
low_using_credit
promo_carrying
healthy
BillingDocumentCounts
credit_noteinvoicereceiptstatementBillingDocumentDetail
oneOf
Exactly one variant must match.
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: statement, kind | |
| type = object · requires: invoice, kind |
kindEnum values:
statement
BillingStatementDetail · required
BillingDocumentDownload
filenameformatEnum values:
csv
pdf
noteurlBillingDocumentList
as_ofBillingDocumentCounts · required
currencyBillingDocumentRow[] · required
exponentinvoicedBillingDocumentRow
detailBillingDocumentDownload[] · required
idissued_atkindEnum values:
statement
invoice
credit_note
receipt
net_minornet_notenumberperiod_labelperiod_notestatusEnum values:
open
issued
paid
unpaid
applied
void
status_notetax_minortitletotal_minorBillingInvoiceDetail
detailBillingDocumentDownload[] · required
idissued_atkindEnum values:
statement
invoice
credit_note
receipt
net_minornet_notenumberperiod_labelperiod_notestatusEnum values:
open
issued
paid
unpaid
applied
void
status_notetax_minortitletotal_minorBillingDocumentLabelValue[] · required
currencyexponentBillingDocumentLabelValue[] · required
BillingInvoiceLine[] · required
BillingDocumentParties · required
BillingDocumentLabelValue[] · required
BillingDocumentLink[] · required
required
tax_ruleusage_hrefBillingInvoiceLine
amount_minorbodymetaordinalquantitytitleunit_price_minorBillingPromoPool
amount_minorcategoryeligible_categoriesexpires_atlabelpool_idreserved_minorreserved_sessionsspent_atBillingStatementDetail
detailBillingDocumentDownload[] · required
idissued_atkindEnum values:
statement
invoice
credit_note
receipt
net_minornet_notenumberperiod_labelperiod_notestatusEnum values:
open
issued
paid
unpaid
applied
void
status_notetax_minortitletotal_minorBillingStatementSkuTotal[] · required
BillingStatementLine[] · required
closing_cash_minorcurrencyexponentline_countBillingStatementLine[] · required
opening_cash_minorreconcile_notereconcilesBillingDocumentLink[] · required
treasury_revisionversionBillingStatementLine
amount_minorkeylabelnoteoriginsignEnum values:
plus
minus
flat
subBillingStatementSkuTotal
amount_minordetailsku_codeNumberBlockConsumer
countidnametypeProblem
The problem document every error response carries.
codedetailrequest_idstatustitletypecaused_bychanged_resourcesexpensive_filterreasonremediationPromotionalCredit
applied_minorexpires_atremaining_minorRateCoverage
as_ofcurrencyeffective_fromRateCoverageRow[] · required
RateCoverageGap
covered_untilmissingEnum values:
route
rate
both
RateCoverageNeighbour[] · required
prefixrate_microreasonRateCoverageRow
also_prefixesavailable_sinceRateCallerIdRule · required
connection_fee_minorcountrycountry_codeidRateIncrement · required
nameprefixrate_microroute_classRateDestination
also_prefixescountrycountry_codenameprefixRateIncrement
increment_secondsminimum_secondsplan_nameRateLookup
as_ofcontainmentcoveredcurrencyrequired
required
destination_numberdirectionEnum values:
inbound
outbound
required
RatePriceBook · required
required
RateTerms
RateCallerIdRule · required
connection_fee_minoreffective_fromRateIncrement · required
rate_microroute_classUpcomingRateTerms
RateCallerIdRule · required
connection_fee_minoreffective_fromRateIncrement · required
rate_microroute_classnotice_dayspublished_atUsageAmounts
calls_minornumbers_minorpromotional_credit_minorrecording_minorsettling_minortotal_minorvoice_minorUsageDay
UsageProductAmount[] · required
datepartialtotal_minorUsageProductAmount
amount_minorproductEnum values:
trunking
voice
automation
UsageQuantity
billable_secondscallsnumbersobserved_secondsrecorded_secondsUsageRate
atoms_per_unitconnection_fee_minoroffer_idprice_idquantity_increment_atomsquantity_minimum_atomssku_codeunitunit_price_minorUsageRow
UsageAmounts · required
detaildimensionEnum values:
day
product
trunk
subaccount
destination
number_block
category
sku
keylabelparent_keyUsageQuantity · required
required
required
UsageScopes
UsageScope[] · required
UsageScope[] · required
UsageSummary
as_ofUsageProductAmount[] · required
currencyUsageDay[] · required
dimensionEnum values:
day
product
trunk
subaccount
destination
number_block
category
sku
required
required
required
UsageQuantity · required
row_countUsageRow[] · required
UsageScopes · required
UsageAmounts · required
UsageWindow · required