Skip to navigation
API ReferenceBilling

Get phone cost breakdown

Returns everything billed for a phone number: the purchase and every monthly rental.

Authentication

AuthorizationBearer

Pass a JWT access token or an API key (prefixed with tif_live_) as a Bearer token.

Path parameters

phoneIdstringRequiredformat: "uuid"
Phone number ID

Response

Phone cost breakdown
phoneIdstringformat: "uuid"
Phone number identifier
rentalslist of objects
Monthly rental charges history
totalMicrocentslong

Total cost in microcents (purchase + all rentals)

totalUsddouble
Total cost in USD
phoneNumberstring or nullOptional
Phone number in E.164 format
purchaseobject or nullOptional
Phone purchase cost details

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error