Skip to main content

FAQ: Tokens

Frequently asked questions about tokens.

For Phone Tokens, am I charged per request or per result?

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.


Are account and usage calls free?

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.


How do I check my balance and usage?

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.

Did this answer your question?