Look up phone number intelligence
Resolve carrier, line-type, portability, and live-status intelligence for a single E.164 number supplied in the request body — the POST companion to GET /api/v1/numbers/lookup/{phoneNumber}. Uses Devotel HLR as primary with a Telnyx fallback. Pass an optional Twilio-compatible fields selector to request add-on data packages (e.g. sim_swap, cnam, line_type_intelligence); the response then carries a dataPackages map. Each answered lookup is billed once via the number_lookup wallet channel (sandbox mode is free). Requires the numbers:write scope.
Authorizations
Dashboard JWT token from Clerk
Body
Phone number to look up, in E.164 format (e.g. +14155550123).
Optional Twilio-compatible data-package selector — a comma-separated string or a JSON array of field names (max 16).
Prior-express-consent date (YYYY-MM-DD) required to realise the reassigned_number data package; ignored otherwise.