Phone ListCleanerDocs

Quickstart

Sign up, buy credits, clean a phone list, and download results. Should take about five minutes end-to-end.

1. Create an account

Go to Sign up and create an account with your email. You'll get a verification email within a few seconds. Confirm it before continuing, the rest of the dashboard is locked behind a verified address.

2. Buy a credit pack

Open the Pricing page and pick the smallest pack that covers your list. One credit cleans one unique number. Duplicates and obviously-malformed rows are free.

PackCreditsPrice
Small Clean2,500$19
List Clean10,000$49
Bulk Clean50,000$149
Large Clean100,000$249
Pro Clean250,000$499

Checkout is via Stripe. You'll be redirected back to the app when payment completes; your credit balance updates automatically.

3. Prepare your file

CSV, TSV, XLSX, TXT, and JSON inputs work. Spreadsheets need a header row, TXT can be one phone per line, and JSON can be an array of phone strings or contact objects. We auto-detect phone columns when they're named something obvious (phone, mobile, cell), but you can select any column from the picker. See the CSV format guide for full details.

4. Upload and confirm

Visit Upload and drop the file. You'll see:

  • The header row and a 5-row preview
  • A phone-column picker with our best guess pre-selected
  • A worst-case credit cost vs. your current balance

Nothing is debited at this point. Click Start cleaning to confirm. The batch is queued the same second, and a worker usually picks it up before the page finishes the redirect.

5. Watch the batch run

You'll be redirected to the batch detail page, which polls every two seconds. Completion time depends on row count, cache hits, and provider response time.

6. Download results

When the batch shows completed, the main downloads appear:

  • full_results.csv: every uploaded row enriched with a normalised E.164 number, country, line type, carrier, sms_ready, call_ready, the reason we classified it that way, and whether it duplicates an earlier row.
  • sms_ready_only.csv: just the rows where sms_ready=true. Drop this straight into your SMS tool and you're done.

The same page can also prepare filtered exports for valid_rows_only.csv, call_ready_only.csv, and deduped_best_rows.csv. All download links are short-lived signed URLs. Re-generate them from the batch detail page any time.

From the API instead

Prefer code? Every step above is also reachable from /v1. Sign up and buy credits in the web app, then create an API key on the API keys page and run:

# Single number
curl -X POST https://your-app.example.com/v1/lookup \
  -H "Authorization: Bearer plc_<your-key>" \
  -d '{"phone":"+447400123456"}'

# Account snapshot
curl https://your-app.example.com/v1/account \
  -H "Authorization: Bearer plc_<your-key>"

# List your batches
curl https://your-app.example.com/v1/batches \
  -H "Authorization: Bearer plc_<your-key>"

See the API reference for the full contract and try requests live in the API explorer.

Next steps