Skip to main content

FAQ: Tokens

Frequently asked questions about tokens.

Am I charged per request or per result?

You are charged only when a call returns data. If a lookup finds no match, the credit cost for that call is zero. You can confirm this in the response metadata, where tokens_charged shows what the call cost and 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.


What are external tokens?

MoltSets resolves most contact data from its own database and charges a standard credit whenever it finds a result. When a record isn't in that database, MoltSets can call a third-party source to try to find it, and those calls draw on external tokens. External tokens sit separately from your credit balance. They're consumed only when a third-party call is actually made, so a standard lookup never uses them, and neither does a call that returns no data. Your allocation depends on your plan.


Am I required to buy external tokens?

No. MoltSets returns data without them. Once you've used up your monthly gifted external tokens, you may see fewer results on the endpoints and tools that rely on third-party calls, but topping up is optional.


Can I choose not to use external tokens?

There's currently no way to switch off your monthly gifted external tokens while they last. Once they're exhausted, you're under no obligation to buy more.


Do external tokens expire?

Gifted external 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 external 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 external tokens, gifted or purchased, are removed from your account.


How many external tokens do I have?

Your external token allocation depends on your plan:

Plan

External Tokens

Free

100 (lifetime)

$27 / month

100 / month

$97 / month

500 / month

$997 / month

2500 / month


Which calls use external tokens?

The number of external tokens used is dependent on the data requested and whether or not MoltSets has the informational internally for a given record.

Did this answer your question?