Plug your system into registry screening.

At a glance

Quick start

Five calls from an empty account to an annotated file.

1. Fund a balance and get your key

Add funds at https://leadloom.thewoob.com/tools. Your first top-up creates the account and emails your access key once. Store it like a password.

2. Upload the file

curl -s -F "[email protected]" {{BASE}}/api/dnc-upload/analyze

Returns 201 with a token, the detected phone columns and quote.unique_valid_phones. If status is needs_mapping, tell us which columns hold phone numbers:

curl -s -X POST {{BASE}}/api/dnc-upload/{{TOKEN}}/mapping \
  -H "Content-Type: application/json" \
  -d '{"phone_fields": ["Phone", "Mobile"]}'

3. Quote it against your balance

curl -s "{{BASE}}/api/tools/v1/dnc/quote?upload_token={{TOKEN}}" \
  -H "Authorization: Bearer $LEADLOOM_KEY"

4. Start the job

curl -s -X POST {{BASE}}/api/tools/v1/dnc/jobs \
  -H "Authorization: Bearer $LEADLOOM_KEY" \
  -H "Content-Type: application/json" \
  -d '{"upload_token": "{{TOKEN}}", "idempotency_key": "batch-2026-09-12-001"}'

201 means the hold is placed and the job is queued. Retrying the same idempotency_key returns the same job with 200 and never holds money twice.

5. Poll, then download

curl -s {{BASE}}/api/tools/v1/jobs/{{JOB_ID}} -H "Authorization: Bearer $LEADLOOM_KEY"
# when "status" is "complete", "download_url" is present:
curl -s -o results.csv {{BASE}}{{DOWNLOAD_URL}}

Small files finish in seconds; a file at the limit takes a few minutes. Poll every few seconds. The job also has a private status_url page you can hand to a teammate.

Concepts

Statuses

What comes back

The result CSV keeps every original row and column, in order. For each phone column you selected, four columns are appended:

The job summary carries the counts: rows, unique_valid_phones, registry_match_phones, no_match_phones, invalid_phone_cells, blank_phone_cells.

Endpoints

{
  "token": "0TFfu7rlRkgZrNOfFlyld1KjKQn0Q16Q",
  "status": "analyzed",
  "row_count": 12,
  "headers": ["First Name", "Last Name", "Phone", "City"],
  "suggested_fields": ["Phone"],
  "phone_fields": ["Phone"],
  "quote": {"unique_valid_phones": 9, "price_per_phone": 0.10, "minimum": 10.00, "amount": 10.00},
  "expires_at": "2026-10-12T18:41:14+00:00"
}

{
  "upload_token": "0TFfu7rlRkgZrNOfFlyld1KjKQn0Q16Q",
  "upload_status": "analyzed",
  "input_rows": 12,
  "billable_units": 9,
  "unit_price_cents": 10,
  "total_cents": 90,
  "available_cents": 2500,
  "max_unique": 10000
}

{
  "id": 1,
  "service": "dnc",
  "status": "queued",
  "upload_status": "queued",
  "billable_units": 9,
  "unit_price_cents": 10,
  "reserved_cents": 90,
  "final_cents": null,
  "price_version": "dnc:10c",
  "input_rows": 12,
  "idempotency_key": "batch-2026-09-12-001",
  "original_filename": "leads.csv",
  "summary": null,
  "status_url": "/dnc-list-scrubbing/order/0TFfu7rlRkgZrNOfFlyld1KjKQn0Q16Q",
  "error": null,
  "created_at": "2026-09-12T14:03:22+00:00",
  "retention_until": "2026-10-12T18:41:14+00:00"
}

{
  "id": 1,
  "status": "complete",
  "upload_status": "complete",
  "final_cents": 90,
  "summary": {"rows": 12, "unique_valid_phones": 9, "registry_match_phones": 3,
              "no_match_phones": 6, "invalid_phone_cells": 1, "blank_phone_cells": 1},
  "download_url": "/api/dnc-upload/0TFfu7rlRkgZrNOfFlyld1KjKQn0Q16Q/download",
  "completed_at": "2026-09-12T14:03:31+00:00"
}

{
  "account_email": "[email protected]",
  "available_cents": 2410,
  "held_cents": 0,
  "spent_cents": 90,
  "funded_cents": 2500,
  "unit_price_cents": 10,
  "topup_min_cents": 2500,
  "topup_presets_cents": [2500, 5000, 10000, 25000]
}

Errors

Every error is {"error": "customer-safe message", "code": "stable_code"}, sometimes with extra fields named above. Codes are stable; messages may change.

Your data

• Your file is processed for one purpose: producing your result. The records in it are never added to any LeadLoom database, sold, shared or reused.
• Only the phone numbers are sent to the registry source. Names, addresses and every other column stay with us and come back to you unchanged.
• Uploaded files and results live in private storage behind unguessable links and are deleted 30 days after upload. Download your results before then.
• Each checked phone number is kept with its registry result in an internal lookup cache and reused for at most 30 days, without any other column from your file.
• Access keys are stored only as a hash. The plaintext exists once, in the email that delivers it. Rotate in the portal; the old key stops immediately. Never put a key in a URL.
• Keys grant access to your own account only. They cannot read LeadLoom data products or anyone else's files.

What the results mean

LeadLoom reports what the National Do Not Call Registry source returned for each number at the time of the check, labeled with one of the four values above. That is registry information, delivered accurately and quickly, with your file intact. It is not legal advice, and it does not by itself establish that any call or text is permitted: consent, established business relationships, state lists and your own internal do-not-call list are yours to manage. Read the Terms for the full statement.

Help

Stuck, need a larger limit, or lost a key? Contact LeadLoom from the email on the account. Balances never expire, and unused balance is refunded to the original payment method on request.