Home/API docs/Changelog
Δ API Changelog

2026-08-17 - v1.4

  • ?country=XX - read a national-format number (8663982896, 866-398-2896) against that country's numbering plan. Same option for CSV uploads, where it applies to the whole file.
  • hint field on every valid: false result - says what would resolve the number instead of leaving you with an empty payload.
  • New error 400 invalid_country for an unknown country code. Spends no quota.
  • Per-key rate limit raised from 60 to 300 requests / minute - a script walking a list no longer trips it.

2026-07-19 - v1.3

  • formats.national / formats.international - display-ready number formats.
  • country.timezone - IANA capital timezone for all 205 countries.
  • carrier - range-holder carrier (allocation-time, null for US/CA and most landlines).
  • risk.complaints.categories - what FTC complainants said the calls were about (15 category codes).
  • risk.complaints.geography - victim spread across US states (distinct count + top 5).
  • risk.fcc_complaints + fcc_reported signal - independent second US government source (FCC unwanted-calls complaints).
  • New endpoint GET /v1/account/usage - quota state, free.
  • Error responses carry a human message; every keyed response ships X-RateLimit-* headers; all 429s ship Retry-After.
  • Quota alert emails at 75% / 90% / 100%. OpenAPI spec published at /openapi.yaml.

2026-07-19 - v1.2

  • risk.complaints - FTC Do Not Call complaint history per US number (220K+ numbers, ingested daily).

2026-07-18 - v1.1

  • risk.signals - per-number risk signals: line type (VoIP / premium / shared-cost) and known-bad prefix ranges (satellite, premium, UK 070).

2026-07-18 - v1.0

  • Launch: GET /v1/phone/{number} - validation, E.164, country, line type, area, country scam profile. Free 1,000 lookups/month, magic-link cabinet.