Docs

API + Batch reference, operational notes, and examples.

Overview

e164.it exposes a minimal HTTP API to normalize phone inputs and produce VoIP / CRM-friendly outputs. You can use the web UI (Single / Batch) or call the endpoints directly.

API reference

Operational notes

  • Security — headers, rate limiting, logging hygiene
  • FAQ — common pitfalls & examples

Quick start

Single (JSON)

curl -s \
  -H "content-type: application/json" \
  -d '{"input":"0039 333 123 4567","default_region":"IT","options":{"format":["e164","rfc3966"],"classify":true,"mask":{"mode":"last4"},"hash":{"enabled":true}}}' \
  https://e164.it/v1/parse

Batch (CSV upload)

curl -s \
  -F "file=@sample.csv" \
  -F "phone_column=phone" \
  -F "default_region=IT" \
  -F "has_header=true" \
  -F "delimiter=auto" \
  -F "mask_mode=none" \
  -F "hash_enabled=false" \
  https://e164.it/v1/batch/parse \
  -o result.csv

Tip: you can also grab fixtures from Samples.

Authentication & rate limits

If enabled for your project, send your key via x-api-key. The web UI stores it locally in your browser (localStorage) for convenience.

When rate limiting is enabled, responses may include: x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset.