Phone Tokens are charged when a mobile phone lookup returns data. If the lookup finds no match, the credit cost for that call is zero. You can confirm this in the response metadata, where phone_tokens_charged shows what the call cost and phone_tokens_remaining shows your balance afterwards.

Yes. get_account, get_billing, and get_usage never consume credits, so you can poll them as often as you need to track your balance and consumption.

Call get_billing for your plan, current balance, and the credit cost of each tool. Call get_usage with a period of today, week, month, or billing_cycle for a day-by-day breakdown of calls made, credits spent, successful lookups, empty results, and failures.

Gifted phone tokens (the ones included with your subscription at no extra charge) roll over at the end of the month if you don't use them, but they expire at the end of the following month. This gives each gifted token a lifespan of up to 60 days.

Each month, tokens are consumed in this order: rolled-over gifted tokens first, then the current month's allocation, and finally any purchased tokens. This means gifted tokens are used up before they have a chance to expire wherever possible.

Purchased phone tokens do not expire. They roll over and remain available for as long as your account is active.

If you cancel your subscription, any remaining phone tokens, gifted or purchased, are removed from your account.

Your phone token allocation depends on your plan: