Frequently asked questions
Quick answers to the most common questions. Email us if yours isn't here.
- How do you validate the numbers?
- We pair a local parser that catches obviously-bad rows for free with a paid validation engine that confirms reachability, line type, and carrier. The local pass runs first so we never spend a credit on input that wouldn't have survived parsing.
- How are you cheaper than the alternatives?
- Three things: we deduplicate before any paid call, we cache successful lookups for 24 hours, and our pricing is one-time prepaid (no monthly minimum, no per-month commitment).
- How accurate is the line type?
- Mobile / landline / toll-free are typically 95%+ accurate in mature markets (UK, US, EU). VoIP detection is patchy by nature, portability and number reuse make it impossible to get right 100% of the time.
- Do you store my phone numbers?
- Yes, we have to, in order to deliver the result CSV and to power the 24-hour cache. Numbers are stored encrypted and masked (first 4 + last 2 digits only) in our internal logs. We never share them with third parties beyond the validation lookup. Batch files and result CSVs are deleted from object storage 90 days after upload; see the Trust page for full retention windows.
- How do you handle my data overall?
- The Trust page (/trust) is the single source of truth: at-a-glance table, encryption details, subprocessors, country coverage, security contact, and what we explicitly do not claim (no SOC 2 yet, no contractual SLA, no HLR).
- Can I delete my data?
- Yes, from the Account page (Danger zone). Deletion is a two-step flow: request → 30-day reversal window → hard purge. After the purge we scrub PII (email, name, identifiers) and delete your API keys, webhooks, and purchase records. Aggregate analytics rows stay anonymised so we can keep the admin dashboards correct.
- How long does deletion take?
- 30 days from when you click Delete in the Danger zone. You can cancel any time during that window via the same screen.
- What's the row limit?
- 100,000 rows per batch and 1 active batch at a time in v1. We'll raise both after we've processed enough real customer load.
- Do credits expire?
- No. They sit in your account until you spend them.
- What happens if our validation engine is unreachable?
- The pipeline marks affected rows as provider_unavailable and refunds the credit. Where possible we fall back to local-only enrichment (E.164, country, line-type when it's derivable locally) so you still get a usable row. You can retry the batch when the engine is back.
- Is there a REST API?
- Yes, single lookup, bulk lookup, account snapshot, batch list, and batch download URLs. Bearer-token auth with scopes + optional expiry, signed webhooks, Idempotency-Key support. See the API reference and try it live in the Explorer.
- What's the API rate limit?
- 6000 requests per minute and 1000000 requests per day per API key. The bulk endpoint (100 numbers per call) counts as one request, use it for throughput.
- Will you build a Zapier / HubSpot integration?
- The integration research points to Google Sheets, HubSpot, Salesforce, Pipedrive, and Zapier as the first targets. Today, the fastest path is CSV upload/download plus the REST API and signed webhooks for automation-style flows.
- Why didn't this number validate?
- Three reasons: (1) malformed_input, the row wasn't a parseable phone number (free, not billed); (2) valid_landline / valid_toll_free, we successfully validated but it's not SMS-able; (3) provider_unavailable, temporary provider hard-fail; we refunded the credit, you can retry the batch.
- What's the difference between a cache hit and a fresh lookup?
- Both return the same fields. A cache hit means we looked up that exact E.164 number within the last 24 hours and reused the result; it costs zero credits and shows cached=true on the row. A fresh lookup goes through the paid validation engine and costs one credit; cached=false.
- Can I get receipts for my purchases?
- Yes. The Billing page lists every purchase with an 'Invoice' link (Stripe-hosted PDF, the formal document for your books) and a 'Receipt' link (charge confirmation). If a purchase still says 'Get receipt', click it to fetch the documents from Stripe on demand.